@mihaldmo/deepseek-code
v0.1.1
Published
Terminal-native AI coding agent powered by DeepSeek
Readme
DeepSeek Code
A terminal-native AI coding agent — powered by DeepSeek, with multi-agent workflows, tool execution, and MCP extensibility.
Features
- Native terminal UI built with Ink (React)
- Autonomous multi-step agent loop with 19 built-in tools
- DeepSeek models:
deepseek-flashanddeepseek-v4-pro - Switch models, profiles, and agents on the fly
- MCP server support — configure, toggle, and monitor in-app
Documentation
Install
git clone https://github.com/your-repo/deepseek-code.git
cd deepseek-code
bun installRun
bun run devBuild
bun run buildQuick setup
You can configure via environment variables or .deepseek-code.json.
Environment variables
export DEEPSEEK_API_KEY="..."
export DEEPSEEK_MODEL="deepseek-flash" # or deepseek-v4-pro
export DEEPSEEK_BASE_URL="https://api.deepseek.com/v1" # optional, for proxies.deepseek-code.json
Copy .deepseek-code.example.json and edit values.
The config file supports:
- default model and API key
- named profiles for different model setups
- MCP server definitions
Available Models
deepseek-flash- General-purpose coding assistant (default)deepseek-v4-pro- Frontier reasoning for complex tasks
The V3-era ids (deepseek-chat, deepseek-reasoner) still resolve as aliases; a saved setting
naming one is migrated to its current name.
MCP
DeepSeek Code supports the Model Context Protocol for extending capabilities:
- Define
mcpServersin.deepseek-code.json /mcpcommand to view and toggle servers at runtime- Active MCP servers displayed in the status bar
See docs/MCP.md for examples and roadmap.
Useful in-app commands
/help/setup/model,/models/apikey/agent/thinking/mcp/shortcuts
Type / to open the command picker. Use arrows to navigate.
Developer notes
- Runtime: Bun
- Language: TypeScript
- UI: Ink (React TUI)
- Agent engine: ai-sdk-cpp (native C++)
For code structure and data flow, see docs/ARCHITECTURE.md.
License
MIT
