deepcode-self-refer

A reference guide for using and configuring the Deep Code command-line tool, including its commands, settings, Skills, MCP connections, permissions, notifications, and saved sessions. MCP is a standard way for an AI tool to connect to outside services.

In plain words
What is it for?
Use it to explain configuration, available commands and models, MCP server setup, web search, permissions, notifications, session history, or editor integration.
Why use it?
It helps answer Deep Code setup and troubleshooting questions from the bundled documentation instead of relying on guesswork.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lessweb/deepcode-cli/deepcode-self-refer
Any agent
npx skills add lessweb/deepcode-cli --skill deepcode-self-refer
Clone the repo
git clone --depth 1 https://github.com/lessweb/deepcode-cli

Made for: Claude Code, Codex.

Per session 86 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,962 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00086 $0.01962
Opus 5 $0.00043 $0.00981
Sonnet 5 $0.00017 $0.00392
Haiku 4.5 $0.00009 $0.00196

Measured yesterday against content hash 48bfee898ce2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

deepcode-self-refer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/core/templates/skills/bundled/deepcode-self-refer/SKILL.md · 146 lines

How it starts

The opening of the file, as written. The whole thing — 146 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Deep Code Self-Refer

This Skill helps you answer user questions about Deep Code CLI itself by consulting the reference documentation bundled with this Skill. All docs live in the references/ subdirectory — always refer to them for authoritative answers.

When to use this Skill

Use this Skill when the user asks any question about Deep Code itself, such as:

  • "列出可用的 skills"
  • "如何配置 MCP?"
  • "给当前项目配置 playwright mcp"
  • "怎么启用搜索功能?"
  • "支持哪些模型?"
  • "如何配置思考模式?"
  • "怎么设置权限?"
  • "任务完成后怎么发通知?"
  • "支持哪些斜杠命令?"
  • "会话历史保存在哪里?"
  • "/undo 是怎么工作的?"
  • "Deep Code 和 VSCode 插件怎么配合?"
  • Any other question about Deep Code CLI's features, configuration, or usage.

Instructions

Step 1: Identify the topic

Map the user's question to the appropriate document(s):

Topic Document Key contents
Overview, features, quick start references/README.md Installation, slash commands, keyboard shortcuts, supported models, FAQ
Configuration & settings references/configuration.md settings.json fields, config hierarchy, env vars, thinking mode, reasoning effort, webSearchTool, enabledSkills
MCP setup & usage references/mcp.md MCP server config format, GitHub/Playwright/Filesystem examples, tool naming (mcp__<name>__<tool>), troubleshooting
Permissions references/permission.md Permission scopes (10 types), allow/deny/ask/defaultMode config, priority rules, persistence
Notifications references/notify.md Notify script path, injected env vars, Slack/Feishu/iTerm2/macOS/Linux/Windows examples
Session persistence references/session-persistence.md Storage paths, JSONL format, session index, compaction, /undo mechanics, code snapshots

Read the full file on GitHub · 146 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 146 lines · 86 tokens per session scan A 48bfee898ce2

Subscribe to this mod's changes

deepcode-self-refer is a skill published in the GitHub repository lessweb/deepcode-cli (2,224 stars, last pushed 4d ago), licensed MIT. It adds 86 tokens to every session and 1,962 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.