Summary

ClawCodex is a production-ready Python implementation of the Claude Code agent, offering a robust CLI tool for developers. It translates the original TypeScript architecture into idiomatic Python, focusing on a reliable agent runtime and extensive LLM provider support, enabling flexible and cost-effective agentic coding workflows.

How It Works

This project is a high-fidelity Python port of the Claude Code reference implementation, rebuilt with an emphasis on idiomatic Python and a production-oriented runtime. It features a core tool-calling loop, streaming REPL, session history, and multi-turn execution. A key differentiator is its multi-provider support, allowing seamless integration with various LLM vendors beyond Claude models, providing users with flexibility in choosing cost-effective and performant AI stacks.

Quick Start & Requirements

• Installation: Clone the repository, create and activate a Python 3.10+ virtual environment, install dependencies (pip install -r requirements.txt), and run python -m src.cli login to configure API keys. The REPL can then be started with python -m src.cli.
• Prerequisites: Python 3.10+.
• Configuration: The clawcodex login command interactively sets up API keys for supported LLM providers (Anthropic, OpenAI, GLM, Minimax, OpenRouter, DeepSeek) and saves them to ~/.clawcodex/config.json.
• Documentation: Architecture overview is available at docs/ARCHITECTURE.md.

Highlighted Details

• Streaming Agent Experience: Provides live output rendering, visible tool activity, and stable fallback behavior for interactive and automated use.
• Programmable Skill Runtime: Supports custom skills defined via Markdown (SKILL.md) files, enabling extensibility with named arguments and tool restrictions.
• Multi-Provider Support: Designed to integrate with a wide array of LLM providers, offering flexibility in model selection and cost management.
• Interactive REPL & TUI: Features a default prompt_toolkit + Rich REPL with tab completion and an optional Textual-based TUI.
• Generated Demos: Includes several applications (CRM, LinkedIn, Minecraft) entirely generated by ClawCodex itself, showcasing its capabilities.

Maintenance & Community

The project is under "Active Development • New Features Weekly." While specific community channels like Discord or Slack are not listed, contributions are welcomed.

Licensing & Compatibility

The project is released under the MIT License, permitting commercial use and integration without significant restrictions.

Limitations & Caveats

The "Context Building" and "Permission System" components are marked as "in progress." Full "MCP" (Model Context Protocol) runtime polish is also ongoing.