English · 简体中文

Terminal-native coding agent for DeepSeek models. Single Go binary, three interfaces (TUI / Web SPA / Desktop), provable prefix-cache stability, real OS sandbox, and signal-driven model routing.

Measured, not claimed. 94.7% prefix cache-hit rate on deepseek-v4-flash vs 0% for a cache-naive agent — 4.5× cheaper. Every figure from DeepSeek's own prompt_cache_hit_tokens. Reproduce: make demo-cache. Evidence: bench/.

Head-to-head (2026-06-10) vs Reasonix on 5 real open-source issues (gRPC, Cobra, chi): dsc resolved 7/10 (70%) vs Reasonix 6/10 (60%); Reasonix hit 93.9% cache vs dsc 89.6% but burned 3 DNFs on turn-cap overruns. Full results.

• Provable prefix-cache stability — single canonical serializer for wire bytes and cache fingerprint; dsc trace inspect shows prefixes==1 (docs/reference/prefix-cache.md).
• Signal-driven Flash→Pro routing — escalates on ambiguity / repeated repair; Duet pro-validator on destructive calls (docs/reference/duet.md).
• Real OS sandbox — sandbox-exec (macOS) / Landlock (Linux) with real PTY (docs/reference/sandbox.md).
• Auto reasoning-effort — per-turn thinking on/off via keyword detection; low/medium/high/max effort, auto-dialed on simple tasks.

Build web-embedded binary: make build-web.

• 14 built-in tools — file read/write/edit/patch, bash, glob, grep, git (diff/show/blame/log), questions, todo tracking.
• Subagents — define in .deepseek/agent/<name>.md; built-in profiles for explore, implement, review, autonomous.
• Skills — SKILL.md discovery from .deepseek/skills/, .claude/skills/, etc. Cache-stable progressive disclosure. Auto-promoted to slash commands.
• Hooks — PreToolUse, PostToolUse, SessionStart, SessionEnd. Fail-open. In-process or subprocess.
• Memory — persistent BM25-indexed long-term memory, JSONL storage, SHA dedup, near-duplicate reconciliation.
• CodeGraph — tree-sitter knowledge graph for structural queries (callers/callees/definitions). Available as MCP server.
• MCP — Model Context Protocol servers via config. None enabled by default.
• Snapshots & /undo — pre-mutation file snapshots. /undo restores last step. Atomic rollback for multi-file patches.
• Permissions — read-only mode (--read-only), ask-all (--ask-all), auto-approve (--yolo). Per-pattern bash gates.

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/amemiya02/deepseekcode/main/install.sh | sh

# Homebrew
brew install amemiya02/deepseekcode/deepseekcode

# Scoop
scoop bucket add deepseekcode https://github.com/amemiya02/deepseekcode-scoop
scoop install deepseekcode

# Go
go install github.com/amemiya02/deepseekcode/cmd/dsc@latest

# From source
git clone https://github.com/amemiya02/deepseekcode && cd deepseekcode
make build && ./bin/dsc -version

Requires: DEEPSEEK_API_KEY (or configured provider key). Git and LSP optional.

New to dsc? Follow the getting-started tutorial (zh).

export DEEPSEEK_API_KEY=sk-...

dsc                              # open the TUI
dsc -p "summarize this repo"     # one-shot CLI
dsc --read-only                  # inspect only
dsc -c                           # continue last session
dsc -r <session-id>              # resume specific session
dsc init                         # project config scaffold
dsc doctor                       # check local setup

Layered: built-in defaults → ~/.deepseek/config.toml → ./.deepseek/config.toml → CLI flags.

# Minimal DeepSeek
[active]
provider = "deepseek"

[providers.deepseek]
type = "deepseek"
base_url = "https://api.deepseek.com"
env_var = "DEEPSEEK_API_KEY"

[defaults]
model = "deepseek-v4-flash"
thinking = true

# OpenAI-compatible
# [active]
# provider = "openai"
#
# [providers.openai]
# type = "openai-compat"
# base_url = "https://api.openai.com"
# env_var = "OPENAI_API_KEY"
# default_model = "gpt-4o"

Full reference: docs/reference/config.md · docs/reference/providers.md

Docs index — start here.

• Learn (zh) — Getting started · Core workflow · 7-part tutorial series
• Reference — Config · Tools · Permissions · Prefix cache · more…
• Develop (zh) — Architecture · Contributing

make build       # build ./bin/dsc
make build-web   # build with embedded web SPA
make desktop     # build macOS .app
make test        # go test ./...
make test-race   # go test -race ./...
make lint        # go vet ./...
make fmt         # gofmt -s -w .
make ci          # SPA tests + Go tests

PR checklist: make fmt && make lint && make test

Issues and pull requests welcome. Keep README.md and README.zh-CN.md synchronized with matching ## structure. Document only implemented, testable features. See docs/dev/contributing.md for environment setup, make targets, and the test taxonomy.

Cache design inspired by reasonix.

MIT