CodexClaw

Category: Development & Coding | Uploader: MackDing | Downloads: 0 | Version: v1.0（Latest）

Install and operate a Telegram bot that exposes Codex, MCP, GitHub subagents, repo switching, and minimal frontend dev-server control.

Changelog: Source: GitHub https://github.com/MackDing/CodexClaw

Directory Structure

Current level: Root

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 899 B
  - 📄 release.yml 877 B
  - 📄 telegram-smoke.yml 692 B
📁 docs/
- 📁 superpowers/
  - 📁 plans/
    
    📄 2026-03-14-tests-scripts-typescript-migration.md 15.3 KB
    
    📄 2026-03-14-typescript-runtime-migration.md 20.7 KB
    
    📄 2026-03-15-frontend-dev-layer.md 3.9 KB
    
    📄 2026-03-15-release-standard-hardening.md 11.1 KB
  - 📁 specs/
    
    📄 2026-03-14-tests-scripts-typescript-migration-design.md 6.3 KB
    
    📄 2026-03-14-typescript-runtime-migration-design.md 7.1 KB
    
    📄 2026-03-15-frontend-dev-layer-design.md 2.7 KB
    
    📄 2026-03-15-release-standard-hardening-design.md 9.3 KB
- 📄 enterprise-architecture.md 5.3 KB
- 📄 operations.md 1.8 KB
- 📄 phase-1-roadmap.md 4.1 KB
- 📄 release.md 3.4 KB
📁 scripts/
- 📄 healthcheck.ts 821 B
- 📄 telegramSmoke.ts 2.1 KB
📁 src/
- 📁 bot/
  - 📄 commandUtils.ts 1.9 KB
  - 📄 formatter.ts 5.4 KB
  - 📄 handlers.ts 24.2 KB
  - 📄 i18n.ts 41.6 KB
  - 📄 middleware.ts 472 B
- 📁 cron/
  - 📄 scheduler.ts 4.3 KB
- 📁 lib/
  - 📄 errors.ts 146 B
- 📁 ops/
  - 📄 healthcheck.ts 9.1 KB
- 📁 orchestrator/
  - 📁 skills/
    
    📄 githubSkill.ts 14.7 KB
    
    📄 mcpSkill.ts 5.3 KB
  - 📄 mcpClient.ts 9.7 KB
  - 📄 router.ts 2.3 KB
  - 📄 skillRegistry.ts 3.6 KB
- 📁 runner/
  - 📄 commandLine.ts 931 B
  - 📄 devServerManager.ts 9.4 KB
  - 📄 ptyManager.ts 49.0 KB
  - 📄 ptyPreflight.ts 1.7 KB
  - 📄 shellManager.ts 5.7 KB
- 📄 config.ts 11.2 KB
- 📄 index.ts 4.0 KB
- 📄 runtimeStateStore.ts 2.5 KB
📁 tests/
- 📁 typecheck/
  - 📄 github-skill-types.ts 305 B
  - 📄 i18n-locale.ts 192 B
  - 📄 mcp-skill-types.ts 181 B
  - 📄 runtime-services.ts 642 B
  - 📄 utility-module-types.ts 566 B
- 📄 commandUtils.test.ts 1.3 KB
- 📄 config-files.test.ts 1.5 KB
- 📄 config.test.ts 7.6 KB
- 📄 devServerManager.test.ts 3.5 KB
- 📄 errors.test.ts 599 B
- 📄 formatter.test.ts 2.7 KB
- 📄 githubSkill.test.ts 7.6 KB
- 📄 handlers.test.ts 11.1 KB
- 📄 healthcheck.test.ts 5.0 KB
- 📄 i18n.test.ts 1.1 KB
- 📄 mcpClient.test.ts 5.0 KB
- 📄 mcpSkill.test.ts 2.7 KB
- 📄 middleware.test.ts 1.8 KB
- 📄 ptyManager.test.ts 19.3 KB
- 📄 ptyPreflight.test.ts 1.2 KB
- 📄 router.test.ts 2.6 KB
- 📄 runtimeStateStore.test.ts 2.0 KB
- 📄 scheduler.test.ts 1006 B
- 📄 shellManager.test.ts 4.5 KB
- 📄 skillRegistry.test.ts 1.8 KB
- 📄 telegramSmoke.test.ts 532 B
📄 .env.example 1.1 KB
📄 .gitignore 77 B
📄 .prettierignore 58 B
📄 .prettierrc.json 97 B
📄 AGENTS.md 2.7 KB
📄 ecosystem.config.cjs 80 B
📄 ecosystem.config.ts 527 B
📄 eslint.config.js 154 B
📄 eslint.config.ts 1.0 KB
📄 package-lock.json 119.7 KB
📄 package.json 2.1 KB
📄 README.md 21.2 KB
📄 SKILL.md 1.7 KB
📄 tsconfig.json 424 B

SKILL.md

---
name: CodexClaw
description: Install and operate a Telegram bot that exposes Codex, MCP, GitHub subagents, repo switching, and minimal frontend dev-server control.
---

# CodexClaw

## What This Skill Does

- runs Codex through Telegram
- keeps coding sessions scoped to `chat + repo`
- exposes `/repo`, `/status`, `/skill`, `/gh`, `/mcp`, and `/dev`
- supports frontend repo debugging with `/dev start|stop|status|logs|url`

## Install

```bash
git clone https://github.com/MackDing/CodexClaw.git
cd CodexClaw
npm install
cp .env.example .env
```

## Required Env

Set at least:

```bash
BOT_TOKEN=123456789:telegram-token
ALLOWED_USER_IDS=123456789
STATE_FILE=.codex-telegram-claws-state.json
WORKSPACE_ROOT=.
CODEX_WORKDIR=.
CODEX_BACKEND=sdk
```

## Start

```bash
npm run start
```

## Verify

```bash
npm run check
npm run lint
npm run format:check
npm test
npm run healthcheck
```

## Telegram Quick Use

```text
/status
/repo
/skill
/repo my-project
/dev status
/gh create repo my-new-repo
/gh confirm
```

## Frontend Debugging

Use these commands inside the current repo selected by `/repo`:

- `/dev start`
- `/dev stop`
- `/dev status`
- `/dev logs`
- `/dev url`
- `/gh create repo ...`, `/gh push`, and `/gh commit "..."` are explicit write paths
- `/gh confirm` executes the pending GitHub write action
- plain-text `create repo`, `commit`, and `push` requests are blocked and turned into guidance

Rules:

- `dev` script is preferred
- `start` script is used as fallback
- frontend runtime is shared per repo, not per chat
- `/dev` is not a general-purpose shell

## Notes

- `superpowers` is an internal workflow and shows up in `/status`, not as a toggleable `/skill`
- `/sh` remains a restricted operator channel and is separate from `/dev`

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

CodexClaw

Directory Structure

SKILL.md

Report

Notice