Python 3.10+ on macOS, Linux, or WSL. No account, no telemetry — bring your own API key.
One line installs uv, Python 3.10+, and the clawcodex command on your PATH. Works on macOS, Linux, and WSL — no account, no telemetry.
# installs uv + Python 3.10+ and the clawcodex command
curl -fsSL https://clawcodex.app/install.sh | bashThen run clawcodex login to add a provider and API key. The installer also ships clawcodex doctor, verify, update, and uninstall.
Clone the repo, create a virtual environment, and install requirements. Python 3.10+ on macOS, Linux, or WSL.
git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txtPrefer uv? uv venv --python 3.11 && uv pip install -e ".[dev]" gives you the clawcodex entry point.
Run the interactive login. It asks for a provider, an API key, an optional base URL and default model, then sets your default provider. Config is written to ~/.clawcodex/config.json.
python -m src.cli login
# or, with the entry point installed:
clawcodex loginTAVILY_API_KEY (from tavily.com) is required for the WebSearch tool. Add it under the env block of your config.
Start the REPL in any project. Plan mode is read-only by default; switch to an editing mode when you are ready to let it act.
cd path/to/project
clawcodex
# headless / scripting:
clawcodex -p "Summarize src/cli.py"Inside the REPL, type / to see commands and skills, /tools to list the registry, and /tui to hand off to the Textual UI.
Pick the row that matches your setup. Each path installs the same clawcodex runtime.
uv venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[dev]"Installs the package plus the clawcodex entry point and dev extras.
uv pip install -r requirements.txt
uv pip install -e .Requirements first, then an editable install of the package.
git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex
pip install -e .[dev]Useful for hacking on the runtime itself or contributing patches.
Configuration and session state live under your home directory.
~/.clawcodex/
├── config.json providers, models, advisor, env
├── skills/ user skills (each with SKILL.md)
└── sessions/ saved conversations
./.clawcodex/ project-scoped skills (optional, per-repo)On first run the CLI offers to create a config file if one is missing. Keys are obfuscated at rest.