{"id":50125528,"url":"https://github.com/lessweb/deepcode-cli","last_synced_at":"2026-06-09T11:00:55.067Z","repository":{"id":354409459,"uuid":"1223512305","full_name":"lessweb/deepcode-cli","owner":"lessweb","description":"Deep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制以及 Agent Skills。","archived":false,"fork":false,"pushed_at":"2026-06-05T05:47:24.000Z","size":1097,"stargazers_count":1124,"open_issues_count":35,"forks_count":94,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-06-05T07:35:17.866Z","etag":null,"topics":["ai-agent","deepseek"],"latest_commit_sha":null,"homepage":"https://deepcode.vegamo.cn","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lessweb.png","metadata":{"files":{"readme":"README-en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T11:51:19.000Z","updated_at":"2026-06-05T07:02:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lessweb/deepcode-cli","commit_stats":null,"previous_names":["qorzj/deepcode-cli"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/lessweb/deepcode-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessweb%2Fdeepcode-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessweb%2Fdeepcode-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessweb%2Fdeepcode-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessweb%2Fdeepcode-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lessweb","download_url":"https://codeload.github.com/lessweb/deepcode-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessweb%2Fdeepcode-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34103357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","deepseek"],"created_at":"2026-05-23T20:00:20.650Z","updated_at":"2026-06-09T11:00:55.061Z","avatar_url":"https://github.com/lessweb.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cbr/\u003e\n\u003cbr/\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href='https://deepcode.vegamo.cn/'\u003e\n    \u003cimg src='https://avatars.githubusercontent.com/u/118287711?s=200\u0026v=4' width='100' alt=\"deepcode-cli\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch1\u003eDeep Code CLI\u003c/h1\u003e\n\n[![][npm-release-shield]][npm-release-link] [![][npm-downloads-shield]][npm-downloads-link] [![][github-contributors-shield]][github-contributors-link] [![][github-forks-shield]][github-forks-link] [![][github-stars-shield]][github-stars-link]\n[![][github-issues-shield]][github-issues-link] [![][github-issues-pr-shield]][github-issues-pr-link] [![][github-license-shield]][github-license-link]\n\nEnglish · [中文](./README.md)\n\n\u003cbr/\u003e\n\u003c/div\u003e\n\n[Deep Code](https://github.com/lessweb/deepcode-cli) is a terminal AI coding assistant optimized for the `deepseek-v4` model, with support for deep thinking, reasoning effort control, Agent Skills, and MCP (Model Context Protocol) integration.\n\n\n## Installation\n\n```bash\nnpm install -g @vegamo/deepcode-cli\n```\n\nRun `deepcode` inside any project directory to get started.\n\n![intro2](resources/intro2.png)\n\n## Configuration\n\nCreate `~/.deepcode/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"MODEL\": \"deepseek-v4-pro\",\n    \"BASE_URL\": \"https://api.deepseek.com\",\n    \"API_KEY\": \"sk-...\"\n  },\n  \"thinkingEnabled\": true,\n  \"reasoningEffort\": \"max\"\n}\n```\n\nThe configuration file is shared with the [Deep Code VSCode extension](https://github.com/lessweb/deepcode) — configure once, use everywhere.\n\nFor complete configuration details (multi-level priority, environment variables, etc.), see [docs/configuration.md](docs/configuration.md).\n\n## Key Features\n\n### **Skills**\nDeep Code CLI supports agent skills that allow you to extend the assistant's capabilities:\n\nSkills are discovered from these locations, in priority order:\n\n| Scope   | Path                  | Purpose                       |\n| :------ | :-------------------- | :---------------------------- |\n| Project | `./.deepcode/skills/` | Deep Code's native location   |\n| Project | `./.agents/skills/`   | Cross-client interoperability |\n| User    | `~/.deepcode/skills/` | Deep Code's native location   |\n| User    | `~/.agents/skills/`   | Cross-client interoperability |\n\n### **Optimized for DeepSeek**\n- Specifically tuned for DeepSeek model performance.\n- Reduce costs by using [Context Caching](https://api-docs.deepseek.com/guides/kv_cache).\n- Natively supports [Thinking Mode](https://api-docs.deepseek.com/guides/thinking_mode) and Effort Control.\n\n## Slash Commands \u0026 Keyboard Shortcuts\n\n| Slash Command    | Action                                                  |\n|------------------|---------------------------------------------------------|\n| `/`              | Open the skills / commands menu                         |\n| `/new`           | Start a fresh conversation                              |\n| `/resume`        | Choose a previous conversation to continue              |\n| `/continue`      | Continue the active conversation or pick one to resume  |\n| `/model`         | Switch model, thinking mode, and reasoning effort       |\n| `/raw`           | Toggle display mode (Normal / Lite / Raw scrollback)    |\n| `/init`          | Initialize an AGENTS.md file (LLM project instructions) |\n| `/skills`        | List available skills                                   |\n| `/mcp`           | View MCP server status and available tools              |\n| `/undo`          | Restore code and/or conversation to a previous point    |\n| `/exit`          | Quit (also `Ctrl+D` twice)                              |\n\n| Key              | Action                                                   |\n|------------------|----------------------------------------------------------|\n| `Enter`          | Send the prompt                                          |\n| `Shift+Enter`    | Insert a newline (also `Ctrl+J`)                         |\n| `Ctrl+V`         | Paste an image from the clipboard                        |\n| `Esc`            | Interrupt the current model turn                         |\n| `Ctrl+D` twice   | Quit Deep Code                                           |\n\n## Supported Models\n\n- `deepseek-v4-pro` (Recommended)\n- `deepseek-v4-flash`\n- Any other OpenAI-compatible model\n\n## FAQ\n\n### Does Deep Code have a VSCode extension?\n\nYes. Deep Code offers a full-featured VSCode extension, available on the [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=vegamo.deepcode-vscode). The extension shares the `~/.deepcode/settings.json` configuration file with the CLI, so you can switch seamlessly between the terminal and the editor.\n\n### Does Deep Code support understanding images?\n\nDeep Code supports multimodal input — you can paste images from the clipboard with `Ctrl+V`. However, `deepseek-v4` does not support multimodal yet. Some models have multimodal capabilities but impose strict limits on multi-turn dialogue requests. For multimodal input, we recommend using the Volcano Ark `Doubao-Seed-2.0-pro` model, which has the best integration.\n\n### How to automatically send a Slack message after a task completes?\n\nWrite a shell notification script that calls a Slack webhook, then set the `notify` field in `~/.deepcode/settings.json` to the full path of the script. For detailed steps, see [docs/notify_en.md](docs/notify_en.md).\n\n### How do I enable web search?\n\nDeep Code comes with a built-in, free Web Search tool that works well for most use cases. If you prefer to use a custom script for web search, set the `webSearchTool` field in `~/.deepcode/settings.json` to the full path of your script. For detailed steps, refer to: https://github.com/qorzj/web_search_cli\n\n### Does it support Coding Plan?\n\nYes. Just set `env.BASE_URL` in `~/.deepcode/settings.json` to an OpenAI-compatible API endpoint. Take Volcano Ark's Coding Plan as an example:\n\n```json\n{\n  \"env\": {\n    \"MODEL\": \"ark-code-latest\",\n    \"BASE_URL\": \"https://ark.cn-beijing.volces.com/api/coding/v3\",\n    \"API_KEY\": \"**************\"\n  },\n  \"thinkingEnabled\": true\n}\n```\n\n### How do I configure MCP?\n\nDeep Code supports MCP (Model Context Protocol) to connect external services such as GitHub, browsers, databases, and more. Configure the `mcpServers` field in `settings.json` to enable it, then use the `/mcp` command to view MCP server status and available tools.\n\nFor detailed setup instructions, see: [docs/mcp.md](docs/mcp.md)\n\n### How to configure Deep Code to send notifications after a task completes?\n\nWhen the AI assistant completes a task, Deep Code can automatically execute a notification script to send the task results to the specified channel (e.g., Slack, system notifications, etc.).\n\nFor detailed configuration instructions, see: [docs/notify_en.md](docs/notify_en.md)\n\n### Does Deep Code only support YOLO mode?\n\nNo. Deep Code has a built-in fine-grained permission control mechanism that lets you confirm operations before the AI assistant executes shell commands, reads/writes files, accesses the network, and more. You can configure each permission scope's policy — always allow, always ask, or deny — via the `permissions` field in `settings.json`. See [docs/permission.md](docs/permission.md) for details.\n\n## Contributing\n\nContributions are welcome! Here's how to get started:\n\n```bash\n# Clone the repository\ngit clone https://github.com/lessweb/deepcode-cli.git\ncd deepcode-cli\n\n# Install dependencies\nnpm install\n\n# Local development (typecheck + lint + format check + bundle)\nnpm run build\n\n# Run tests\nnpm test\n\n# Link globally (local global install)\nnpm link\n```\n\n- Make sure `npm run check` passes before submitting a PR (typecheck + lint + format check)\n- We recommend running `npm run format` before building to avoid errors\n\n## Getting Help\n\n- Report bugs or request features on GitHub Issues (https://github.com/lessweb/deepcode-cli/issues)\n\n## License\n\n- MIT\n\n## Support Us\n\nIf you find this tool helpful, please consider supporting us by:\n\n- Giving us a Star on GitHub (https://github.com/lessweb/deepcode-cli)\n- Submitting feedback and suggestions\n- Sharing with your friends and colleagues\n\n\n\u003c!-- LINK GROUP --\u003e\n\n[npm-release-link]: https://www.npmjs.com/package/@vegamo/deepcode-cli\n[npm-release-shield]: https://img.shields.io/npm/v/@vegamo/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026logo=npm\u0026logoColor=white\u0026style=flat-square\u0026cacheSeconds=1800\n[npm-downloads-link]: https://www.npmjs.com/package/@vegamo/deepcode-cli\n[npm-downloads-shield]: https://img.shields.io/npm/dt/@vegamo/deepcode-cli?labelColor=black\u0026style=flat-square\u0026color=4d6BFE\u0026cacheSeconds=1800\n[github-contributors-link]: https://github.com/lessweb/deepcode-cli/graphs/contributors\n[github-contributors-shield]: https://img.shields.io/github/contributors/lessweb/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026style=flat-square\u0026cacheSeconds=1800\n[github-forks-link]: https://github.com/lessweb/deepcode-cli/network/members\n[github-forks-shield]: https://img.shields.io/github/forks/lessweb/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026style=flat-square\u0026cacheSeconds=1800\n[github-stars-link]: https://github.com/lessweb/deepcode-cli/network/stargazers\n[github-stars-shield]: https://img.shields.io/github/stars/lessweb/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026style=flat-square\u0026cacheSeconds=1800\n[github-issues-link]: https://github.com/lessweb/deepcode-cli/issues\n[github-issues-shield]: https://img.shields.io/github/issues/lessweb/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026style=flat-square\u0026cacheSeconds=1800\n[github-issues-pr-link]: https://github.com/lessweb/deepcode-cli/pulls\n[github-issues-pr-shield]: https://img.shields.io/github/issues-pr/lessweb/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026style=flat-square\u0026cacheSeconds=1800\n[github-license-link]: https://github.com/lessweb/deepcode-cli/blob/main/LICENSE\n[github-license-shield]: https://img.shields.io/github/license/lessweb/deepcode-cli?color=4d6BFE\u0026labelColor=black\u0026style=flat-square\u0026cacheSeconds=1800\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flessweb%2Fdeepcode-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flessweb%2Fdeepcode-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flessweb%2Fdeepcode-cli/lists"}