Architecture
The six core abstractions and the golden path from input to output. The recommended starting point for contributors.
Read ARCHITECTURE.md →
docs
Documentation
The deep reference lives in the repository. This hub points you at the right file, then shows the everyday surface: REPL commands and CLI flags.
Setup guide
Detailed installation, including uv, editable installs, and provider configuration.
Open SETUP_GUIDE.md →Feature list
The capability matrix: what is complete, what is in progress, and PR guidelines.
Open FEATURE_LIST.md →Testing
How the pytest suites are organized and how to run them locally.
Open TESTING.md →
Section 01 · repl
Slash commands
| Command | Description |
|---|---|
/ | Show commands and skills |
/help | Help text |
/tools | List tool names from the registry |
/tool <name> <json> | Run a tool directly with JSON input |
/stream on|off|toggle | Toggle live response streaming |
/render-last | Re-render the last reply as Markdown |
/save · /load <id> | Persist or restore a session |
/clear | Clear conversation (also /reset, /new) |
/tui | Switch to the Textual TUI |
/context | Workspace and prompt context |
/compact | Compact or clear the conversation |
/exit · /quit · /q | Exit |
Section 02 · cli
Command line
clawcodex
Start the inline REPL (default)
clawcodex --tui
Launch the Textual TUI
clawcodex --stream
REPL with live rendering
clawcodex login
Configure API keys interactively
clawcodex -p "Find TODOs" --allowed-tools Read,Grep
Headless, restricted tools
clawcodex --provider anthropic --model claude-sonnet-4-6 -p "Hi"
Per-run provider/model override
clawcodex --permission-mode plan
Read-only investigation