v1.2.80 · npm latest MIT License

DeepCode

Terminal-first AI coding agent — local, permission-aware, and multi-provider.

DeepCode operates locally with a permission model you control — read, write, shell, and dangerous operations each have configurable approval policies. Works with Anthropic, OpenAI, DeepSeek, Groq, Ollama, OpenRouter, and MCP.

Get Started View on GitHub
npm install -g deepcode-ai
deepcode ~/repo 
$ deepcode run "ship auth" --yes
reading workspace, tests, and git diff
✓ plan created with 4 permission-gated steps
✓ patched 3 files and updated focused tests
approval required: shell:test
✓ npm test -- auth/session.spec.ts

Features

TUI

Interactive TUI

Ink-based terminal UI with real-time streaming, diff previews, approval flows, and Vim keybindings.

RUN

Non-interactive mode

deepcode run for scripting and CI pipelines — fully automated task execution.

LLM

Multi-provider LLM

Anthropic, OpenAI, DeepSeek, Groq, Ollama, OpenRouter, OpenCode — with automatic failover and per-mode routing.

TLS

Tool System

Filesystem read/write, shell, ripgrep search, git, lint, test runners, LSP symbols — all permission-gated.

MCP

MCP Support

Connect any Model Context Protocol server; tools appear automatically in the agent with server__ prefix.

GIT

GitHub Integration

Authenticate, browse issues, manage pull requests, and run AI code review on any PR from your terminal.

CTX

Context Management

Auto-summarizes conversation history when approaching the model's context limit. Configurable token budgets with hard stops.

SEC

Safety Model

Path allowlist/blacklist, per-operation permission levels, approval gateway, audit logging, and secret redaction.

INT

Intent Classification

Answers greetings, trivial questions, and project discovery without calling an LLM — saving tokens and latency.

Supported Providers

Anthropic
anthropic
Claude 3.x / 4.x family
OpenAI
openai
GPT-4o, o3, o4-mini
DeepSeek
deepseek
deepseek-chat, deepseek-reasoner
Groq
groq
Fast inference, Llama / Mixtral
Ollama
ollama
Local models, no API key required
OpenRouter
openrouter
Unified access to 200+ models
OpenCode
opencode
opencode-go/ model prefix

Core Commands

$ deepcode
Launch interactive TUI
$ deepcode chat
Start a chat session
$ deepcode run "fix the failing tests" --yes
Non-interactive task execution
$ deepcode config show --effective
View effective configuration
$ deepcode doctor
Check installation health
$ deepcode update
Check for updates
$ deepcode github login
Authenticate with GitHub
$ deepcode github review 42
AI code review on a PR
$ deepcode subagents run --task "audit auth" --concurrency 2 --yes
Run parallel subagents

Safety Model

DeepCode acts on a real local repository, so safety is a first-class runtime concern.

FS

Path Control

Allowlist and blacklist enforcement for filesystem access.

ACL

Permission Levels

read, write, gitLocal, shell, dangerous — each with configurable approval policy.

OK

Approval Gateway

Sensitive operations require approval with diff previews before execution.

LOG

Audit Logging

All tool calls are logged for review and debugging.

KEY

Secret Redaction

Known secrets are automatically redacted from logs and agent output.

Get Started

1

Install

Requires Node.js 22 or newer.

npm install -g deepcode-ai

or

pnpm add -g deepcode-ai
2

Configure

deepcode init
deepcode config set defaultProvider deepseek
deepcode config set providers.deepseek.apiKey "sk-..."
3

Run

deepcode doctor
deepcode