Repolode
lessweb

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. 1

    Install the CLI globally with npm

    npm install -g @vegamo/deepcode-cli
  2. 2

    Create ~/.deepcode/settings.json with your model, base URL and API key

  3. 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