codeep 2.12.0 → 2.13.1

package/dist/acp/session.d.ts

@@ -26,4 +26,13 @@ export interface AgentSessionOptions {
  * Falls back to a minimal synthetic context if scanning fails.
  */
 export declare function buildProjectContext(workspaceRoot: string): ProjectContext;
+export declare function toolCallMeta(toolName: string, params: Record<string, string>, workspaceRoot: string): {
+    kind: string;
+    title: string;
+};
+export declare function buildRawOutput(toolName: string, params: Record<string, string>, toolResult: {
+    success: boolean;
+    output: string;
+    error?: string;
+}): string | undefined;
 export declare function runAgentSession(opts: AgentSessionOptions): Promise<void>;

package/dist/acp/session.js

@@ -24,7 +24,10 @@ export function buildProjectContext(workspaceRoot) {
     };
 }
 // Maps internal tool names to ACP tool_call kind values and human titles.
-function toolCallMeta(toolName, params, workspaceRoot) {
+// Exported (not just module-private) so it can be unit-tested in isolation —
+// testing it through runAgentSession would require mocking the entire agent
+// loop, which would defeat the point of covering this mapping.
+export function toolCallMeta(toolName, params, workspaceRoot) {
     const file = params.path ?? params.file ?? '';
     // Use full path for edit tools (Zed renders it as a clickable file link)
     const absFile = file
@@ -51,7 +54,8 @@ function toolCallMeta(toolName, params, workspaceRoot) {
 // Builds rawOutput content to display inside tool call cards.
 // For write/edit operations, returns the code content or diff.
 // For command execution, returns the command output.
-function buildRawOutput(toolName, params, toolResult) {
+// Exported for direct unit testing (see session.test.ts).
+export function buildRawOutput(toolName, params, toolResult) {
     // Always surface error details when a tool fails
     if (!toolResult.success && toolResult.error) {
         return `Error: ${toolResult.error}`;

package/dist/config/index.d.ts

@@ -14,8 +14,8 @@ interface ProviderApiKey {
     providerId: string;
     apiKey: string;
 }
-type AgentMode = 'on' | 'manual';
-interface ConfigSchema {
+type AgentMode = 'on' | 'manual' | 'off';
+export interface ConfigSchema {
     apiKey: string;
     provider: string;
     model: string;

package/dist/config/providers.d.ts

@@ -26,6 +26,10 @@ export interface ProviderConfig {
     maxOutputTokens?: number;
     useMaxCompletionTokens?: boolean;
     requiresDefaultTemperature?: boolean;
+    /** Provider's OpenAI-compatible endpoint rejects `tools` together with
+     *  `stream: true` (Alibaba/Qwen DashScope). When true, agent turns that send
+     *  tools are issued non-streamed (we buffer the full response). */
+    noStreamWithTools?: boolean;
     envKey?: string;
     subscribeUrl?: string;
     noApiKey?: boolean;
@@ -68,6 +72,12 @@ export declare function usesMaxCompletionTokens(providerId: string): boolean;
  * (e.g. OpenAI GPT-5+ only accepts the default of 1).
  */
 export declare function requiresDefaultTemperature(providerId: string): boolean;
+/**
+ * Returns true if the provider's OpenAI-compatible endpoint rejects `tools`
+ * together with `stream: true` (Alibaba/Qwen) — callers must issue tool-bearing
+ * agent turns non-streamed.
+ */
+export declare function providerNoStreamWithTools(providerId: string): boolean;
 export declare function modelRejectsSamplingParams(model: string): boolean;
 /**
  * Returns the effective max output tokens for a provider, capped by the provider's limit.

package/dist/config/providers.js

@@ -203,6 +203,196 @@ export const PROVIDERS = {
         groupLabel: 'DeepSeek',
         hint: 'Pay-per-use via DeepSeek API key (platform.deepseek.com).',
     },
+    // ── Kimi (Moonshot AI) ────────────────────────────────────────────
+    // Subscription (Kimi Code) mirrors the Z.AI GLM-Coding-Plan shape: a
+    // dedicated coding base URL + a separate key, model id ALWAYS
+    // `kimi-for-coding` (a backend alias). OpenAI-compatible is the
+    // battle-tested path so we don't expose the Anthropic surface here.
+    'kimi': {
+        name: 'Kimi (Moonshot) — Coding Plan',
+        description: 'Kimi Code subscription',
+        protocols: {
+            openai: { baseUrl: 'https://api.kimi.com/coding/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'kimi-for-coding', name: 'Kimi Code', description: 'Subscription alias — auto-maps to the latest Kimi coding model (K2.7 Code)' },
+        ],
+        defaultModel: 'kimi-for-coding',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 32_768,
+        envKey: 'KIMI_CODE_API_KEY',
+        subscribeUrl: 'https://www.kimi.com/code',
+        groupLabel: 'Kimi — Subscription (Kimi Code)',
+        hint: 'Uses your Kimi Code subscription — no per-token charges. Key from kimi.com/code/console.',
+    },
+    'kimi-api': {
+        name: 'Kimi (Moonshot) API (pay-per-use)',
+        description: 'Moonshot AI Kimi models via API key',
+        protocols: {
+            openai: { baseUrl: 'https://api.moonshot.ai/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'kimi-k2.7-code', name: 'Kimi K2.7 Code', description: 'Flagship agentic coding model (256K context)' },
+            { id: 'kimi-k2.7-code-highspeed', name: 'Kimi K2.7 Code (High-Speed)', description: 'Throughput-tuned K2.7 Code for latency-sensitive loops' },
+            { id: 'kimi-k2.6', name: 'Kimi K2.6', description: 'Previous-gen multimodal reasoning model' },
+            { id: 'kimi-k2.5', name: 'Kimi K2.5', description: 'Older general-purpose model (cheaper)' },
+        ],
+        defaultModel: 'kimi-k2.7-code',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 32_768,
+        envKey: 'MOONSHOT_API_KEY',
+        subscribeUrl: 'https://platform.kimi.ai/console/api-keys',
+        groupLabel: 'Kimi — API (pay-per-use)',
+        hint: 'Pay-per-use via Moonshot API key (platform.kimi.ai).',
+    },
+    'kimi-cn': {
+        name: 'Kimi China (Moonshot)',
+        description: 'Moonshot AI Kimi models (China)',
+        protocols: {
+            openai: { baseUrl: 'https://api.moonshot.cn/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'kimi-k2.7-code', name: 'Kimi K2.7 Code', description: 'Flagship agentic coding model (256K context)' },
+            { id: 'kimi-k2.7-code-highspeed', name: 'Kimi K2.7 Code (High-Speed)', description: 'Throughput-tuned K2.7 Code' },
+            { id: 'kimi-k2.6', name: 'Kimi K2.6', description: 'Previous-gen multimodal reasoning model' },
+            { id: 'kimi-k2.5', name: 'Kimi K2.5', description: 'Older general-purpose model' },
+        ],
+        defaultModel: 'kimi-k2.7-code',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 32_768,
+        envKey: 'MOONSHOT_CN_API_KEY',
+        subscribeUrl: 'https://platform.moonshot.cn/console/api-keys',
+        groupLabel: 'Kimi China — API (pay-per-use)',
+        hint: 'Pay-per-use via Moonshot China API key (platform.moonshot.cn).',
+    },
+    // ── Grok (xAI) ────────────────────────────────────────────────────
+    // Pay-per-use today (console.x.ai key). The SuperGrok / X Premium+
+    // subscription is OAuth-based — added separately. Reasoning models
+    // require max_completion_tokens (like GPT-5), so useMaxCompletionTokens.
+    'grok': {
+        name: 'Grok (xAI)',
+        description: 'xAI Grok models',
+        protocols: {
+            openai: { baseUrl: 'https://api.x.ai/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'grok-build-0.1', name: 'Grok Build 0.1', description: 'Agentic coding model — fast, 256K context' },
+            { id: 'grok-4.3', name: 'Grok 4.3', description: 'Flagship — highest quality, 1M context' },
+            { id: 'grok-code-fast-1', name: 'Grok Code Fast 1', description: 'Low-cost speed-first coder (alias of Build 0.1)' },
+            { id: 'grok-4-fast-reasoning', name: 'Grok 4 Fast (reasoning)', description: 'Cheap reasoning model, very large context' },
+        ],
+        defaultModel: 'grok-build-0.1',
+        defaultProtocol: 'openai',
+        useMaxCompletionTokens: true, // reasoning models reject max_tokens
+        envKey: 'XAI_API_KEY',
+        subscribeUrl: 'https://console.x.ai',
+        groupLabel: 'xAI Grok',
+        hint: 'Pay-per-use via xAI API key (console.x.ai).',
+    },
+    // ── Qwen (Alibaba Model Studio / DashScope) ───────────────────────
+    // Coding Plan subscription = dedicated base URL + sk-sp- key (mirrors
+    // Z.AI). Qwen's OpenAI-compatible surface CANNOT combine tools with
+    // streaming, so all Qwen entries set noStreamWithTools.
+    'qwen': {
+        name: 'Qwen (Alibaba) — Coding Plan',
+        description: 'Qwen Coding Plan subscription',
+        protocols: {
+            openai: { baseUrl: 'https://coding-intl.dashscope.aliyuncs.com/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'qwen3-coder-plus', name: 'Qwen3-Coder Plus', description: 'Flagship coding model — best quality' },
+            { id: 'qwen3-coder-next', name: 'Qwen3-Coder Next', description: 'Balanced quality/speed/cost' },
+            { id: 'qwen3-max', name: 'Qwen3-Max', description: 'Flagship general model (code + reasoning)' },
+        ],
+        defaultModel: 'qwen3-coder-plus',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 65_536,
+        noStreamWithTools: true,
+        envKey: 'BAILIAN_CODING_PLAN_API_KEY',
+        subscribeUrl: 'https://www.alibabacloud.com/help/en/model-studio/qwen-code-coding-plan',
+        groupLabel: 'Qwen — Subscription (Coding Plan)',
+        hint: 'Uses your Qwen Coding Plan — no per-token charges. sk-sp-… key from Model Studio. Interactive coding use only.',
+    },
+    'qwen-api': {
+        name: 'Qwen (Alibaba) API (pay-per-use)',
+        description: 'Alibaba Model Studio Qwen models via API key',
+        protocols: {
+            openai: { baseUrl: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'qwen3-coder-plus', name: 'Qwen3-Coder Plus', description: 'Flagship coding model (256K, up to 1M)' },
+            { id: 'qwen3-coder-next', name: 'Qwen3-Coder Next', description: 'Balanced quality/speed/cost' },
+            { id: 'qwen3-coder-flash', name: 'Qwen3-Coder Flash', description: 'Fast/cheap coder' },
+            { id: 'qwen3-max', name: 'Qwen3-Max', description: 'Flagship general model' },
+        ],
+        defaultModel: 'qwen3-coder-plus',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 65_536,
+        noStreamWithTools: true,
+        envKey: 'DASHSCOPE_API_KEY',
+        subscribeUrl: 'https://modelstudio.console.alibabacloud.com/',
+        groupLabel: 'Qwen — API (pay-per-use)',
+        hint: 'Pay-per-use via Alibaba Model Studio key (DASHSCOPE_API_KEY).',
+    },
+    'qwen-cn': {
+        name: 'Qwen China — Coding Plan',
+        description: 'Qwen Coding Plan subscription (China)',
+        protocols: {
+            openai: { baseUrl: 'https://coding.dashscope.aliyuncs.com/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'qwen3-coder-plus', name: 'Qwen3-Coder Plus', description: 'Flagship coding model — best quality' },
+            { id: 'qwen3-coder-next', name: 'Qwen3-Coder Next', description: 'Balanced quality/speed/cost' },
+            { id: 'qwen3-max', name: 'Qwen3-Max', description: 'Flagship general model' },
+        ],
+        defaultModel: 'qwen3-coder-plus',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 65_536,
+        noStreamWithTools: true,
+        envKey: 'BAILIAN_CODING_PLAN_CN_API_KEY',
+        subscribeUrl: 'https://bailian.console.aliyun.com/',
+        groupLabel: 'Qwen China — Subscription (Coding Plan)',
+        hint: 'Uses your Qwen Coding Plan (China). sk-sp-… key from Bailian.',
+    },
+    'qwen-cn-api': {
+        name: 'Qwen China API (pay-per-use)',
+        description: 'Alibaba Model Studio Qwen models via API key (China)',
+        protocols: {
+            openai: { baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'qwen3-coder-plus', name: 'Qwen3-Coder Plus', description: 'Flagship coding model' },
+            { id: 'qwen3-coder-next', name: 'Qwen3-Coder Next', description: 'Balanced quality/speed/cost' },
+            { id: 'qwen3-coder-flash', name: 'Qwen3-Coder Flash', description: 'Fast/cheap coder' },
+            { id: 'qwen3-max', name: 'Qwen3-Max', description: 'Flagship general model' },
+        ],
+        defaultModel: 'qwen3-coder-plus',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 65_536,
+        noStreamWithTools: true,
+        envKey: 'DASHSCOPE_CN_API_KEY',
+        subscribeUrl: 'https://bailian.console.aliyun.com/',
+        groupLabel: 'Qwen China — API (pay-per-use)',
+        hint: 'Pay-per-use via Alibaba Model Studio China key.',
+    },
+    'modelscope': {
+        name: 'ModelScope (free Qwen)',
+        description: 'Free Qwen3-Coder inference via ModelScope',
+        protocols: {
+            openai: { baseUrl: 'https://api-inference.modelscope.cn/v1', authHeader: 'Bearer', supportsNativeTools: true },
+        },
+        models: [
+            { id: 'Qwen/Qwen3-Coder-480B-A35B-Instruct', name: 'Qwen3-Coder 480B', description: 'Open MoE coder — free tier (~2000 req/day)' },
+        ],
+        defaultModel: 'Qwen/Qwen3-Coder-480B-A35B-Instruct',
+        defaultProtocol: 'openai',
+        maxOutputTokens: 65_536,
+        noStreamWithTools: true,
+        envKey: 'MODELSCOPE_API_KEY',
+        subscribeUrl: 'https://modelscope.cn/my/myaccesstoken',
+        groupLabel: 'ModelScope — Free (Qwen)',
+        hint: 'Free tier (~2000 req/day) via ModelScope token (modelscope.cn). Needs a bound Aliyun account.',
+    },
     'openai': {
         name: 'OpenAI',
         description: 'GPT and o-series models',
@@ -361,14 +551,24 @@ const DISPLAY_ORDER = [
     'openrouter', // 100+ models, one key — surfaced high on purpose for 2.0.0.
     'z.ai',
     'z.ai-api',
+    'kimi',
+    'kimi-api',
+    'qwen',
+    'qwen-api',
+    'grok',
     'deepseek',
     'google',
     'minimax',
     'minimax-api',
+    'modelscope',
     'ollama',
     'custom',
+    // Regional + parameter-variant entries trail.
     'z.ai-cn',
     'z.ai-cn-api',
+    'kimi-cn',
+    'qwen-cn',
+    'qwen-cn-api',
     'minimax-cn',
 ];
 export function getProviderList() {
@@ -441,14 +641,26 @@ export function usesMaxCompletionTokens(providerId) {
 export function requiresDefaultTemperature(providerId) {
     return PROVIDERS[providerId]?.requiresDefaultTemperature ?? false;
 }
+/**
+ * Returns true if the provider's OpenAI-compatible endpoint rejects `tools`
+ * together with `stream: true` (Alibaba/Qwen) — callers must issue tool-bearing
+ * agent turns non-streamed.
+ */
+export function providerNoStreamWithTools(providerId) {
+    return PROVIDERS[providerId]?.noStreamWithTools ?? false;
+}
 /**
  * Models that reject sampling parameters (temperature/top_p/top_k) with a 400.
  * Anthropic removed them on Fable 5 and Opus 4.7+; older Claude models still
  * accept them, so this must be a MODEL-level check, not a provider-level one
  * (requiresDefaultTemperature can't express it). Omitting the field is always
- * safe — the API treats omission as default.
+ * safe — the API treats omission as default. Kimi K2.x code/thinking models
+ * fix temperature internally and 400 on any custom value, so they're here too.
  */
-const SAMPLING_PARAMS_REJECTED = ['claude-fable-5', 'claude-opus-4-8', 'claude-opus-4-7'];
+const SAMPLING_PARAMS_REJECTED = [
+    'claude-fable-5', 'claude-opus-4-8', 'claude-opus-4-7',
+    'kimi-k2.7-code', 'kimi-for-coding',
+];
 export function modelRejectsSamplingParams(model) {
     return SAMPLING_PARAMS_REJECTED.some(id => model === id || model.startsWith(`${id}-`));
 }
@@ -508,6 +720,12 @@ export function modelSupportsReasoningEffort(providerId, model) {
             // GLM-5.2 added graded High/Max effort. glm-5-turbo is a plain thinking
             // toggle (no graded levels) so it stays out.
             return idMatches(id, 'glm-5-2');
+        case 'grok':
+            // Grok reasoning models accept reasoning_effort (none/low/medium/high).
+            // Explicit *-non-reasoning variants don't think → excluded.
+            return id.startsWith('grok') && !id.includes('non-reasoning');
+        // Kimi (thinking on/off, not graded) and Qwen coders (non-thinking) have
+        // no graded knob → fall through to default false.
         case 'openrouter':
             // OpenRouter normalizes a unified `reasoning` field and silently ignores
             // it for non-reasoning models, so the control is always safe to expose.
@@ -547,6 +765,9 @@ export function reasoningParamsFor(providerId, model, tier) {
         case 'z.ai-cn-api':
             // Graded thinking depth: high (default) or max. Lower tiers collapse to high.
             return { reasoning_effort: tier === 'max' ? 'max' : 'high' };
+        case 'grok':
+            // none/low/medium/high — no "max"; map our Max → high (the ceiling).
+            return { reasoning_effort: tier === 'max' ? 'high' : tier };
         case 'openrouter':
             // Unified reasoning object; no "max" effort → cap at high.
             return { reasoning: { effort: tier === 'max' ? 'high' : tier } };
@@ -580,6 +801,8 @@ export function availableReasoningTiers(providerId, model) {
         case 'z.ai-cn':
         case 'z.ai-cn-api':
             return ['auto', 'high', 'max'];
+        case 'grok':
+            return ['auto', 'low', 'medium', 'high'];
         case 'openrouter':
             return ['auto', 'low', 'medium', 'high'];
         default:

package/dist/renderer/App.js

@@ -23,125 +23,12 @@ const LOGO_LINES = [
     ' ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝     ',
 ];
 const LOGO_HEIGHT = LOGO_LINES.length;
-// Command descriptions for autocomplete
-const COMMAND_DESCRIPTIONS = {
-    'help': 'Show help',
-    'status': 'Show status',
-    'settings': 'Adjust settings',
-    'version': 'Show version',
-    'update': 'Check updates',
-    'clear': 'Clear chat',
-    'exit': 'Quit',
-    'sessions': 'Manage sessions',
-    'new': 'New session',
-    'rename': 'Rename session',
-    'search': 'Search history',
-    'export': 'Export chat',
-    'agent': 'Run agent for a task',
-    'agent-dry': 'Preview agent actions',
-    'stop': 'Stop running agent',
-    'undo': 'Undo last action',
-    'undo-all': 'Undo all actions',
-    'history': 'Show agent history',
-    'changes': 'Show session changes',
-    'diff': 'Review git changes',
-    'commit': 'Generate commit message',
-    'git-commit': 'Commit with message',
-    'push': 'Git push',
-    'pull': 'Git pull',
-    'amend': 'Amend the last commit',
-    'pr': 'Create a pull request description',
-    'changelog': 'Generate changelog from recent commits',
-    'branch': 'Create a new branch with smart naming',
-    'stash': 'Stash changes with a meaningful message',
-    'unstash': 'Apply and drop the most recent stash',
-    'init': 'Initialize project (.codeep/)',
-    'scan': 'Scan project',
-    'memory': 'Add/list/remove project memory notes',
-    'review': 'Code review',
-    'copy': 'Copy code block',
-    'paste': 'Paste from clipboard',
-    'apply': 'Apply file changes',
-    'add': 'Add file to context',
-    'drop': 'Remove file from context',
-    'multiline': 'Toggle multi-line input',
-    'test': 'Generate/run tests',
-    'docs': 'Open web docs for a command (e.g. /docs personality)',
-    'refactor': 'Improve code quality',
-    'fix': 'Debug and fix issues',
-    'explain': 'Explain code',
-    'optimize': 'Optimize performance',
-    'debug': 'Debug problems',
-    'test-fix': 'Fix failing tests',
-    'coverage': 'Analyze test coverage and suggest improvements',
-    'e2e': 'Generate end-to-end tests',
-    'mock': 'Generate mock data for testing',
-    'readme': 'Generate or update README',
-    'api-docs': 'Generate API documentation',
-    'translate': 'Translate code comments to English',
-    'types': 'Add or improve TypeScript types',
-    'cleanup': 'Clean up code (remove unused, format)',
-    'modernize': 'Update code to use modern syntax',
-    'migrate': 'Migrate code to newer version',
-    'split': 'Split a large file into smaller modules',
-    'security': 'Security audit',
-    'log': 'Add logging to code',
-    'build': 'Build the project',
-    'deploy': 'Build and deploy',
-    'release': 'Create a new release',
-    'publish': 'Publish package to npm',
-    'component': 'Generate a React/Vue component',
-    'api': 'Generate an API endpoint',
-    'hook': 'Generate a React hook',
-    'service': 'Generate a service/utility module',
-    'page': 'Generate a new page/route',
-    'form': 'Generate a form with validation',
-    'crud': 'Generate full CRUD for an entity',
-    'docker': 'Generate Dockerfile and docker-compose',
-    'ci': 'Generate CI/CD configuration',
-    'env': 'Setup environment configuration',
-    'k8s': 'Generate Kubernetes manifests',
-    'terraform': 'Generate Terraform configuration',
-    'nginx': 'Generate Nginx configuration',
-    'monitor': 'Add monitoring and observability',
-    'skills': 'List all skills',
-    'provider': 'Switch provider',
-    'model': 'Switch model',
-    'protocol': 'Switch protocol',
-    'lang': 'Set language',
-    'grant': 'Grant write permission',
-    'login': 'Change API key',
-    'logout': 'Logout',
-    'account': 'Link this machine to your codeep.dev account',
-    'context-save': 'Save conversation',
-    'context-load': 'Load conversation',
-    'context-clear': 'Clear saved context',
-    'learn': 'Learn code preferences',
-    'cost': 'Show session cost and token usage',
-    'profile': 'Save/load settings profiles',
-    'tasks': 'List/add/done/delete codeep.dev tasks — add <title> [--bug|--feature]',
-    'sync': 'Sync learning preferences and profiles to codeep.dev',
-    'telemetry': 'Show or toggle automatic cloud telemetry (on/off)',
-    'keysync': 'Show or toggle syncing API keys to codeep.dev (on/off)',
-    'thinking': 'Set the thinking/reasoning-effort tier (auto/low/medium/high/max) for models that support it',
-    'effort': 'Alias for /thinking — set the reasoning-effort tier',
-    // 2.0 — surfaced for `/` autocomplete; documented in /help too.
-    'compact': 'Summarize older messages to free up context',
-    'commands': 'List custom slash commands in .codeep/commands/*.md',
-    'checkpoint': 'Snapshot the session (conversation + provider/model + git HEAD)',
-    'checkpoints': 'List saved checkpoints for this workspace',
-    'rewind': 'Restore conversation from a saved checkpoint',
-    'hooks': 'List installed lifecycle hooks (.codeep/hooks/<event>.sh)',
-    'mcp': 'Manage MCP servers (browse, install, add, remove, resources, prompts)',
-    'openrouter': 'Tune OpenRouter routing (preferred / ignore providers, fallbacks, privacy)',
-    'plan': 'Generate a numbered plan for a task — review before /go executes it',
-    'go': 'Execute the pending plan from /plan',
-    'personality': 'Switch agent tone: concise / verbose / security / senior-reviewer / etc',
-    'me': 'Your user profile (reply language, style, stack) — adapts the agent to you. /me init, /me learn, /me sync',
-    'agents': 'List sub-agents the agent can delegate self-contained tasks to (researcher / reviewer / tester / custom)',
-    'insights': 'Activity summary over the last N days (default 7): runs, files, tools, projects',
-    'recall': 'Search across ALL saved sessions (cross-session; /search is current-session only)',
-};
+// ─── Command metadata ────────────────────────────────────────────────────────
+//
+// `COMMAND_DESCRIPTIONS` used to be hand-maintained here in App.ts and kept in
+// sync (manually) with the `/help` screen in components/Help.ts. Both now derive
+// from the single source of truth in `./commands/registry.ts`.
+import { COMMAND_DESCRIPTIONS } from './commands/registry.js';
 import { helpCategories, keyboardShortcuts } from './components/Help.js';
 import { handleSettingsKey, SETTINGS } from './components/Settings.js';
 import { renderExportPanel, handleExportKey as handleExportKeyComponent } from './components/Export.js';

package/dist/renderer/commands/registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Single source of truth for Codeep slash commands.
+ *
+ * Every other place that needs command metadata — the `/` autocomplete in
+ * `App.ts`, the `/help` screen in `components/Help.ts`, the dispatcher in
+ * `commands.ts`, and the ACP command handler in `acp/commands.ts` — derives
+ * from this registry. Adding a command means adding one entry here; the
+ * autocomplete list, help screen, and command index all pick it up.
+ *
+ * ## What lives here vs. elsewhere
+ *
+ * - **`CommandDef`** is metadata only: name, aliases, description, category.
+ *   The actual handler logic stays in `renderer/commands.ts` (CLI) and
+ *   `acp/commands.ts` (ACP) — those files keep their per-command `case`
+ *   blocks, but they now look up the canonical name/description/alias map here.
+ * - **Argument syntax** (e.g. `/rename <name>`, `/mcp browse [id]`) is
+ *   documented via the optional `usage` field — surfaced in `/help` only.
+ *   The autocomplete list shows just the bare command name.
+ * - **Hidden commands** (`hidden: true`) are valid and dispatched, but don't
+ *   appear in the autocomplete dropdown or `/help`. Use for aliases that
+ *   would clutter the list (single-letter shortcuts) and internal commands.
+ *
+ * ## Invariants (enforced by `registry.test.ts`)
+ *
+ * - No two commands share a name or alias.
+ * - Every `category` referenced exists in `CATEGORY_ORDER`.
+ * - `usage` keys never collide with a sibling command's name.
+ */
+/** Display categories, in the order `/help` shows them. */
+export declare const CATEGORY_ORDER: readonly ["general", "sessions", "checkpoints", "agent", "git", "code", "skills", "settings", "extensions", "cloud", "codegen", "thinking"];
+export type CommandCategory = (typeof CATEGORY_ORDER)[number];
+/** Human-readable title for each category (used by `/help`). */
+export declare const CATEGORY_TITLES: Record<CommandCategory, string>;
+export interface CommandDef {
+    /** Primary command name, without the leading `/`. */
+    name: string;
+    /** Alternate names that dispatch to the same handler. Hidden from `/help`
+     *  by default (set `aliasListed: true` to show them, e.g. `/effort`). */
+    aliases?: string[];
+    /** One-line description shown in autocomplete and `/help`. */
+    description: string;
+    /** Display group in `/help`. */
+    category: CommandCategory;
+    /** Extra usage rows shown only in `/help` (e.g. `/mcp browse [id]`).
+     *  Each entry is rendered as a separate row under the same command. */
+    usage?: string[];
+    /** When true, the command is valid but hidden from autocomplete + `/help`.
+     *  Used for single-letter shortcuts and internal aliases. */
+    hidden?: boolean;
+    /** When true, an alias is listed in `/help` alongside the primary name
+     *  (e.g. `/effort` appears next to `/thinking`). Default false — most
+     *  aliases are hidden shortcuts. */
+    aliasListed?: boolean;
+}
+/**
+ * The registry. Order within a category is preserved as-is in `/help`,
+ * so keep entries grouped by category in source for readability.
+ */
+export declare const COMMANDS: CommandDef[];
+/** `name → description` for every visible (non-hidden) command + listed alias.
+ *  This is the data behind the `/` autocomplete dropdown in `App.ts`.
+ *
+ *  Single-letter aliases (the `c`/`t`/`d`/… shortcuts) are deliberately
+ *  EXCLUDED from the dropdown — bare one-letter rows just clutter it (they
+ *  stay fully routable via the dispatcher + show in `/help` as `(/c)` suffixes).
+ *  Multi-letter listed aliases (`effort`, `stats`) are kept; they read as real
+ *  commands, not noise. */
+export declare const COMMAND_DESCRIPTIONS: Record<string, string>;
+/** Every valid command name, including hidden ones and aliases — used by the
+ *  dispatcher to validate input before looking up a handler. */
+export declare const ALL_COMMAND_NAMES: ReadonlySet<string>;
+export declare function resolveCommand(token: string): CommandDef | undefined;
+/** All aliases (every value in `aliases` across the registry), for quick
+ *  "is this a shortcut?" checks. */
+export declare const ALL_ALIASES: ReadonlySet<string>;
+export interface HelpItemSpec {
+    /** Visible key in `/help`, including the leading `/`. */
+    key: string;
+    description: string;
+}
+export interface HelpCategorySpec {
+    title: string;
+    items: HelpItemSpec[];
+}
+/**
+ * Hand-curated help layout. Categories appear in this order; each item's `key`
+ * is rendered verbatim. The command registry provides autocomplete + dispatch
+ * metadata; this layout provides the `/help` rendering. They overlap by design
+ * — keeping both lets the help screen document env vars, subcommand flavors,
+ * and recommended workflows that don't fit the strict command/alias shape.
+ */
+export declare const HELP_LAYOUT: HelpCategorySpec[];