Terminal coding agent for open-source and open-weight coding models — DeepSeek, Moonshot, OpenAI-compatible gateways, vLLM, Ollama, and more. Streams reasoning, edits workspaces behind approval gates, and auto mode picks model + thinking level per turn.
Warning
Install channels are not ready yet. npm / Homebrew / Scoop / crates.io / Docker publishing is still in progress — none of those commands (China mirrors included) work today. Until then, build from source:
git clone https://github.com/camilesing/CodeSmith.git && cd CodeSmith
cargo install --path crates/cli --locked # provides `codesmith`
cargo install --path crates/tui --locked # provides `codesmith-tui` (required companion)A model answers a question; an agent finishes a task. CodeSmith is the harness in between: a written Constitution ranks competing authorities (user intent outranks stale instructions, verification outranks confidence), tools are approval-gated and OS-sandboxed, every turn leaves a rollback snapshot, and up to 20 sub-agents run concurrently. How it all works: docs/HARNESS.md.
codesmith auth set --provider deepseek # or export CODESMITH_API_KEY
codesmith doctor # verify setup & connectivity
codesmith # interactive TUIModes — Plan (read-only) / Agent (default, gated) / YOLO (auto-approve): docs/MODES.md · other providers: docs/PROVIDERS.md
Get started: user guide · modes & approvals · keybindings · skills · memory · localization · full command catalog
Configure: configuration · providers · install · Docker
Internals & extension: harness · architecture · design internals · sandbox · sub-agents · MCP · hooks · runtime API & Zed ACP · ops runbook · release process · changelog
CodeSmith is a fork of CodeWhale (derived from deepseek-tui) — thanks to Hunter Bown and upstream contributors.
Questions & bugs: open an issue · contributing: CONTRIBUTING.md · security: SECURITY.md (no public issues)
Not affiliated with DeepSeek Inc. · License: MIT