Python 3.10+ on macOS, Linux, or WSL — or the native desktop app. 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.
The whole agent in a native window: streaming chat with a live tool trail and reasoning, permission approvals with once/session/always grants, side-by-side previews, and a session sidebar that lists and resumes the same durable sessions as the terminal. It spawns clawcodex serve under the hood, so both surfaces share one config, one session store, one skills set, and one permission system.
This is a preview build: unsigned and un-notarized, so macOS Gatekeeper will refuse a double-click. Right-click the app and choose Open the first time. Intel Macs, Windows, and Linux have no published binary yet — run clawcodex desktop from a checkout there.
Already have the CLI? The same app ships in the repo. The first run installs the UI dependencies; --no-dev builds once and launches Electron directly.
# from a clawcodex checkout
clawcodex desktopClone 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.