Skills
.Work. You
Rest

CodexClaw

Community

Run Codex securely from Telegram—plus MCP & GitHub.

Software Engineering#automation#github#codex#mcp#dev-server#session-persistence#telegram
AuthorMackDing
Version1.0.0
Installs0

System Documentation

What problem does it solve?

CodexClaw solves the problem of safely operating OpenAI Codex from a Telegram chat while keeping execution organized per repository and enabling controlled tool and workflow routing.

Core Features & Use Cases

  • Zero-trust Telegram access: whitelist-only operators using ALLOWED_USER_IDS and secure runtime state persisted in STATE_FILE.
  • Codex coding execution with project scoping: maintains resumable coding sessions per chat + repo and supports /new, /exec, /auto, and /plan.
  • Bot-side control-plane subagents: explicit /mcp ... and /gh ... commands route to MCP server tooling and GitHub automation with confirmations for high-risk writes.
  • Frontend dev-server management: repo-scoped /dev start|stop|status|logs|url to help with iterative development without exposing general shell access.

Quick Start

Clone the repository, install dependencies, copy .env.example to .env, set BOT_TOKEN and ALLOWED_USER_IDS, then start the bot with npm run start.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: CodexClaw
Download link: https://github.com/MackDing/CodexClaw/archive/main.zip#codexclaw

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.