English | 中文 | Français | Русский | हिन्दी | العربية | Português

ClawCodex

A production-oriented Python rebuild of Claude Code — real architecture, reliable CLI agent

Ported from the TypeScript reference implementation and extended with a Python-native runtime

🔥 Active Development • New Features Weekly 🔥

🐋🔥 DeepSeek Prefix Cache

Run long agentic coding sessions for pennies

Cache-hit input bills at ~$0.0435 / 1M tokens — about 230× cheaper than Claude Fable 5 ($10 / 1M).

ClawCodex keeps your request prefix byte-stable, so DeepSeek's prompt cache covers your whole system + tools + history span across turns. The longer you code, the more you save.

⚡ Quick Install

One line — installs uv, Python 3.10+, and puts clawcodex on your PATH:

curl -fsSL https://clawcodex.app/install.sh | bash

Then configure a provider and start coding:

clawcodex login   # interactive provider + API key setup → ~/.clawcodex/config.json
clawcodex --dangerously-skip-permissions         # start the REPL in any project

The installer also ships clawcodex lifecycle helpers — doctor (diagnose your environment), verify (health-check the install), update, and uninstall. It is re-run-safe and works on macOS, Linux, and WSL. To pass flags through the pipe, use curl -fsSL https://clawcodex.app/install.sh | bash -s -- --dry-run.

git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex
python3 -m venv .venv && source .venv/bin/activate   # Python 3.10+
pip install -r requirements.txt

python -m src.cli login   # writes config to ~/.clawcodex/config.json

python -m src.cli --dangerously-skip-permissions   # start the REPL

The configuration file is saved at ~/.clawcodex/config.json. Minimal example:

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "xxx-xxx",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

Note: TAVILY_API_KEY is required for the WebSearch tool — get a key at tavily.com.

The session, settings, and env blocks are optional — sensible defaults apply when they're omitted. See Configure for the full structure.

📰 News

• 2026-07-07: /loop scheduled tasks now actually fire — full port of Claude Code's session-scoped scheduler (#680) — the bundled /loop skill finally has a real engine behind it: a new src/scheduled_tasks module parses standard 5-field cron expressions and fires due prompts between turns from the agent-server's idle poll. CronCreate/CronList/CronDelete register real firing jobs (8-char IDs, 50-job cap, deterministic jitter, 7-day recurring expiry with one final fire), and the new ScheduleWakeup tool drives self-paced /loop mode — the model picks each next delay (1 min–1 hr), stop: true ends the loop, and a ~20-minute fallback wakeup catches iterations that forget to reschedule. Typed skill slash commands now reach the backend (new skill_command control), so /loop 5m check ci works from the composer with completion + argument hint; the TUI shows a live countdown indicator (⟳ loop wakeup in 2m 14s · ⏰ 1 scheduled) and Esc while idle stops a waiting loop. /clear drops session tasks, --resume restores unexpired ones, CLAWCODEX_DISABLE_CRON=1 disables the scheduler. 117 new tests; verified live over stdio NDJSON and a real PTY TUI drive (typed dispatch → CronCreate → a real wakeup fire between turns → Esc-stop).
• 2026-07-07: Bounded the ESC-cancel chunk queue in OpenAI-compatible streaming (#278) — OpenAICompatibleProvider.chat_stream_response's worker-thread queue (added in #148) was an unbounded queue.Queue. A non-graceful disconnect from a proxy that keeps sending bytes after ESC (and never closes the SDK iterator) let the orphaned worker thread accumulate chunks in memory indefinitely. The queue is now capped at 64 chunks, so put() blocks the worker once full instead of growing without bound.
• 2026-07-06 (v1.0.0): ClawCodex v1.0.0 — the 1.0 release: goal-directed autonomy, hooks & MCP wired for production, and a hardened permission system — 86 commits since v0.7.0 (#580–#668) finish wiring the big subsystems end-to-end and graduate ClawCodex to 1.0. Goal-directed autonomy: the /goal + /subgoal completion-condition loop keeps the agent working until an LLM judge confirms the goal is actually met (#664), the new Monitor tool streams long-running shell output with backpressure (#665), background-bash completion notifications (#663), coordinator mode wired end-to-end on the live paths (#634), and /advisor token-efficient worker/reviewer pairing restored on the Ink TUI (#668). Hooks live in production: configured hooks now actually fire — bootstrap Hooks abstraction (#583), UserPromptSubmit (#597), multi-scope + lifecycle hooks (#595), if pre-filters (#643), PreToolUse permissionDecision (#655), PermissionRequest hooks at the ask seam (#637), MCP elicitation hooks (#659), and teammate TaskCompleted / TeammateIdle stop hooks (#642). MCP completion: OAuth server auth via the /mcp flow (#662), live tools/list_changed refresh (#598, #604), server instructions injected into the system prompt (#654), and clawcodex mcp serve re-exposes ClawCodex tools as an MCP stdio server (#635). Permission hardening: readable approval boxes with broadenable, persistent session grants (#608–#611), compound-command permission parity (#622), Bash normalization hardening (#626), disableBypassPermissionsMode lockdown (#660), an honest refuse-to-start unsandboxed guard (#658), subprocess secret-scrubbing (#650), and a flag-gated LLM security-classifier lane for auto mode (#589). TUI maturity: faithful Claude Code look & feel — diff rendering, tool-call transcript, task list, composer + permission-mode badge, busy line (#612–#616) — plus a minimal vim editing engine (#667), Esc-interrupt with a defanged Ctrl+C (#625), fully editable multi-line input (#621), slash-command argument hints (#631), a persistent session-stats line (#657), and restored /cost, /skills, and /model (#627, #629, #630). Reliability: the production compaction pipeline is wired and auto-compact actually applies its result (#587, #607), full retry lane + model fallback + message-history caching (#586), parallel Agent fan-out with the concurrency-cap deadlock fixed (#590), killing a background agent really stops the run (#606), and output styles work end-to-end (#640). Codebase stats: 1,170 Python files, 256,909 lines (up from 233,520 lines on 2026-06-11).
• 2026-06-30 (v0.7.0): ClawCodex v0.7.0 — TUI auto-theming, faithful inline rendering & a Claude-Code-style tool trail — the Ink TUI now detects your terminal's background color (OSC 11) on startup and selects the light/dark theme to match, so text stays readable on any terminal with no env var needed (#577). Inline mode renders truly inline like Claude Code: no screen wipe on launch, and no overlap with prior terminal output on startup or with the returning shell prompt on exit (#573, #575). The tool trail reads Claude-style — workspace-relative paths (Read(src/foo.ts)), Grep(pattern) labels, and a Read N lines result collapse (#574) — and the banner gains a 🦞 mascot with brighter secondary text on dark themes (#576).
• 2026-06-24 (v0.6.0): ClawCodex v0.6.0 — interactive TUI REPL parity — a batch of input ports brings the Python REPL to parity with the ink reference: a working slash-command menu (execute / complete / filter like the ink REPL), the sparkle spinner with a live token + elapsed busy row, context-aware prompt footer hints (interrupt / bash / grammar), the ? shortcuts help panel, an @ file-mention dropdown with in-place splice, double-press Ctrl+C / Ctrl+D to exit, Ctrl+R history search + double-Esc clear-draft, a [Pasted text #N +K lines] large-paste placeholder, and the completed command queue (drain queued prompts + dim preview). Login docs now list all 25 providers (#383).
• 2026-06-23: One-click installer — curl -fsSL https://clawcodex.app/install.sh | bash installs uv (no sudo), provisions Python 3.10+, clones to ~/.clawcodex, creates a lock-pinned venv, and registers clawcodex on PATH; ships status / doctor / verify / update / uninstall subcommands, is safe to re-run, and works on macOS / Linux / WSL.
• 2026-06-21: 18 new LLM providers — the registry grows 7 → 25 (#377) — a data-driven ProviderSpec registry adds 18 OpenAI-compatible backends (nvidia-nim, fireworks, together, moonshot/Kimi, novita, siliconflow, deepinfra, stepfun, arcee, huggingface, volcengine, xiaomi-mimo, atlascloud, wanjie-ark, plus local ollama / vllm / sglang) alongside the hand-written providers; alias-aware config