Crab Code

Open-source alternative to Claude Code, built from scratch in Rust.

English | 中文

Active Development — 4940 tests · 25 crates · ~161k LOC

Crab Code is a Rust-native agentic coding CLI. It aligns with Claude Code's toolset, permission model, and interaction patterns while supporting any LLM provider (Anthropic / OpenAI / DeepSeek / Bedrock / Vertex).

Quick Start

See crab --help for more. Config lives at ~/.crab/config.toml (snake_case TOML); the full loading & merge spec is in docs/config-design.md.

Configuration

Config sources, low → high priority:

- User: ~/.crab/config.toml (or $CRAB_CONFIG_DIR/config.toml)
- Project: $PWD/.crab/config.toml (committed)
- Local: $PWD/.crab/config.local.toml (gitignored)
- --config : CLI-injected file
- -c key.path=value: dotted runtime override (TOML grammar; repeatable)

Example config.toml:

Environment Variables

Env (runtime layer) always wins over file. Mutually-exclusive variants apply highest-first.

Comparison

Architecture

25 Rust crates in 4 layers. See docs/architecture.md for details.

Build & Test

Contributing

PRs welcome.

License

MIT License