An open-source AI agent from Google that brings Gemini into your terminal to query, edit, and automate code.
lessweb/deepcode-cli
A terminal AI coding assistant optimized for DeepSeek models, with deep thinking, reasoning effort control, Agent Skills and MCP integration.
Open-source alternative to:Claude Code
- Stars
- 2,163
- Forks
- 215
- Open issues
- 149
- Last commit
- 7 days ago
What is it?
Deep Code CLI is a terminal coding assistant built specifically around DeepSeek models such as deepseek-v4-pro and deepseek-flash. It runs from any project directory after installing the @vegamo/deepcode-cli npm package, and it shares its settings file with the Deep Code VSCode extension.
The tool exposes DeepSeek's thinking mode directly, with controls for enabling thinking and setting reasoning effort, and it uses context caching to reduce cost. Users can switch models, thinking mode and reasoning effort with the /model command, and resume, fork or undo past sessions.
It supports Agent Skills loaded from project and user directories, MCP servers configured in settings.json, image input via local files or Ctrl+V clipboard paste, and a permission system that can always allow, always ask or deny actions such as shell commands and file access. Any other OpenAI-compatible model can also be used by setting a base URL.
Key features
- 01Deep thinking mode with adjustable reasoning effort for DeepSeek models.
- 02Context caching to reduce token costs.
- 03Agent Skills loaded from project and user directories.
- 04MCP server integration with status and tool listing via /mcp.
- 05Session management with resume, fork and undo.
- 06Image understanding from local files or clipboard paste.
- 07Fine-grained permission control for shell, file and network actions.
Use cases
- Working on coding tasks in a terminal with DeepSeek models.
- Sharing one configuration between the CLI and the VSCode extension.
- Extending an agent with custom Skills and external MCP tools.
- Sending task-completion notifications to services like Slack via a script.
Quick start
- 1
Install the CLI globally with npm
npm install -g @vegamo/deepcode-cli - 2
Create ~/.deepcode/settings.json with your model, base URL and API key
- 3
Run deepcode inside any project directory to start
deepcode
Things to know
- Optimized specifically for DeepSeek models; other models are supported only as generic OpenAI-compatible endpoints.
- Requires a DeepSeek or other OpenAI-compatible API key to use.
Topics
FAQ
- What is deepcode-cli?
- A terminal AI coding assistant optimized for DeepSeek models, with deep thinking, reasoning effort control, Agent Skills and MCP integration. Deep Code CLI is a terminal coding assistant built specifically around DeepSeek models such as deepseek-v4-pro and deepseek-flash. It runs from any project directory after installing the @vegamo/deepcode-cli npm package, and it shares its settings file with the Deep Code VSCode extension.
- Is deepcode-cli free to use? What license does it have?
- deepcode-cli is open source under the MIT license. Check the license terms before using it in commercial products.
- Is deepcode-cli still maintained?
- Actively maintained. The last commit to deepcode-cli was on Oct 15, 2026.
- What can I use deepcode-cli for?
- Working on coding tasks in a terminal with DeepSeek models. Sharing one configuration between the CLI and the VSCode extension. Extending an agent with custom Skills and external MCP tools. Sending task-completion notifications to services like Slack via a script.
- How do I install deepcode-cli?
- Install the CLI globally with npm: npm install -g @vegamo/deepcode-cli Create ~/.deepcode/settings.json with your model, base URL and API key Run deepcode inside any project directory to start: deepcode
- Where can I get deepcode-cli?
- The source code and installation instructions are on GitHub: https://github.com/lessweb/deepcode-cli
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An open-source coding-agent CLI that runs in the terminal and works with cloud APIs and local model backends like Ollama.
An open source AI coding agent that runs in your terminal, with a desktop app and two built-in agents for building and planning changes.
An agentic coding tool from Anthropic that runs in your terminal, reads your codebase, and handles coding tasks and git workflows via natural language.
Open source autonomous coding agent that runs as an IDE extension, terminal CLI, desktop app, or SDK.
An open-source coding agent that reads your project, edits files and runs tests from your terminal, desktop, browser or editor.