codeep 3.2.2 → 3.3.1

package/dist/config/index.d.ts

@@ -183,6 +183,19 @@ export declare function initializeAsProject(path: string): boolean;
  * Check if folder was manually initialized as project
  */
 export declare function isManuallyInitializedProject(path: string): boolean;
+/**
+ * Create config with fallback logic
+ * 1. Try standard Conf location (~/.config/codeep-nodejs on Linux, etc.)
+ * 2. If not writable, use .codeep in current working directory
+ */
+/**
+ * What a fresh install starts on. Exported so a test can hold the pair to the
+ * catalogue: the model had stayed `glm-5.2` after Z.AI's default moved to
+ * `glm-5.3`, so new users started a flagship behind what the website promised,
+ * and nothing failed because 5.2 still works.
+ */
+export declare const DEFAULT_PROVIDER = "z.ai";
+export declare const DEFAULT_MODEL = "glm-5.3";
 export declare const config: Conf<ConfigSchema>;
 export declare const LANGUAGES: Record<string, string>;
 export declare const PROTOCOLS: Record<string, string>;

package/dist/config/index.js

@@ -138,12 +138,20 @@ function isWritable(dir) {
  * 1. Try standard Conf location (~/.config/codeep-nodejs on Linux, etc.)
  * 2. If not writable, use .codeep in current working directory
  */
+/**
+ * What a fresh install starts on. Exported so a test can hold the pair to the
+ * catalogue: the model had stayed `glm-5.2` after Z.AI's default moved to
+ * `glm-5.3`, so new users started a flagship behind what the website promised,
+ * and nothing failed because 5.2 still works.
+ */
+export const DEFAULT_PROVIDER = 'z.ai';
+export const DEFAULT_MODEL = 'glm-5.3';
 function createConfig() {
     const defaults = {
         apiKey: '',
         migrationVersion: 0,
-        provider: 'z.ai',
-        model: 'glm-5.2',
+        provider: DEFAULT_PROVIDER,
+        model: DEFAULT_MODEL,
         agentMode: 'on',
         ollamaUrl: 'http://localhost:11434',
         ollamaNativeApi: false,

package/dist/config/providers.js

@@ -19,7 +19,7 @@ export const PROVIDERS = {
         },
         models: [
             { id: 'glm-5.3', name: 'GLM-5.3', description: 'Latest flagship for project-scale engineering (1M context)' },
-            { id: 'glm-5.3-flash', name: 'GLM-5.3 Flash', description: 'Same 1M context at a twentieth of the price' },
+            { id: 'glm-5.3-flash', name: 'GLM-5.3 Flash', description: 'Same 1M context at roughly a ninth of the price' },
             { id: 'glm-5.2', name: 'GLM-5.2', description: 'Previous flagship for project-scale engineering (1M context)' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant, available to all users' },
         ],
@@ -53,7 +53,7 @@ export const PROVIDERS = {
             // (`z.ai-cn*`) bills separately and is not covered by that page, so it is
             // left alone until its own listing is checked.
             { id: 'glm-5.3', name: 'GLM-5.3', description: 'Latest flagship for project-scale engineering (1M context)' },
-            { id: 'glm-5.3-flash', name: 'GLM-5.3 Flash', description: 'Same 1M context at a twentieth of the price' },
+            { id: 'glm-5.3-flash', name: 'GLM-5.3 Flash', description: 'Same 1M context at roughly a ninth of the price' },
             { id: 'glm-5.2', name: 'GLM-5.2', description: 'Previous flagship for project-scale engineering (1M context)' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant' },
         ],
@@ -80,11 +80,14 @@ export const PROVIDERS = {
                 supportsNativeTools: true,
             },
         },
+        // GLM-5.3 is on the China gateway and the China Coding Plan (bigmodel.cn).
+        // Flash is listed only on China pay-per-use, so the plan does not offer it.
         models: [
-            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Latest flagship for project-scale engineering (1M context)' },
+            { id: 'glm-5.3', name: 'GLM-5.3', description: 'Latest flagship for project-scale engineering (1M context)' },
+            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Previous flagship for project-scale engineering (1M context)' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant, available to all users' },
         ],
-        defaultModel: 'glm-5.2',
+        defaultModel: 'glm-5.3',
         defaultProtocol: 'openai',
         maxOutputTokens: 131_072,
         envKey: 'ZAI_CN_API_KEY',
@@ -109,10 +112,12 @@ export const PROVIDERS = {
             },
         },
         models: [
-            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Latest flagship for project-scale engineering (1M context)' },
+            { id: 'glm-5.3', name: 'GLM-5.3', description: 'Latest flagship for project-scale engineering (1M context)' },
+            { id: 'glm-5.3-flash', name: 'GLM-5.3 Flash', description: 'Same 1M context at a tenth of the price' },
+            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Previous flagship for project-scale engineering (1M context)' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant' },
         ],
-        defaultModel: 'glm-5.2',
+        defaultModel: 'glm-5.3',
         defaultProtocol: 'openai',
         maxOutputTokens: 131_072,
         envKey: 'ZAI_CN_API_KEY',
@@ -207,11 +212,19 @@ export const PROVIDERS = {
                 supportsNativeTools: true,
             },
         },
+        // One model. DeepSeek's own pricing page names `deepseek-flash` (V4.1 Flash)
+        // as the model to use and says it outperforms V4 Pro. `deepseek-v4-flash`
+        // is already served by it, and from 2026-09-14 12:00 Beijing time every
+        // `deepseek-v4-pro` request is routed to it and billed at its price until
+        // a V4.1 Pro exists — so a Pro entry would be a label on a different model.
+        // Both old ids migrate via RETIRED_MODEL_REPLACEMENTS.
+        //
+        // Note the id differs on OpenRouter, which lists the same model as
+        // `deepseek/deepseek-v4.1-flash`.
         models: [
-            { id: 'deepseek-v4-pro', name: 'DeepSeek V4 Pro', description: 'Most capable DeepSeek model (1M context, thinking mode)' },
-            { id: 'deepseek-v4-flash', name: 'DeepSeek V4 Flash', description: 'Fast and affordable DeepSeek model (1M context)' },
+            { id: 'deepseek-flash', name: 'DeepSeek V4.1 Flash', description: 'Current DeepSeek model — thinking on by default, vision, 1M context, 384K output' },
         ],
-        defaultModel: 'deepseek-v4-pro',
+        defaultModel: 'deepseek-flash',
         defaultProtocol: 'openai',
         maxOutputTokens: 384_000, // DeepSeek V4 max output
         envKey: 'DEEPSEEK_API_KEY',
@@ -344,12 +357,17 @@ export const PROVIDERS = {
         protocols: {
             openai: { baseUrl: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1', authHeader: 'Bearer', supportsNativeTools: true },
         },
+        // 3.8 Max and Flash are GA on Model Studio international and cost less
+        // than the 3.7 Max / 3.6 Flash they sit above. China (`qwen-cn-api`) is a
+        // separate listing and is not changed on this evidence.
         models: [
-            { id: 'qwen3.7-max', name: 'Qwen3.7-Max', description: 'Latest flagship for complex coding and reasoning' },
+            { id: 'qwen3.8-max', name: 'Qwen3.8-Max', description: 'Latest flagship for complex coding and reasoning (1M context)' },
+            { id: 'qwen3.8-flash', name: 'Qwen3.8-Flash', description: 'Low-latency, low-cost multimodal model (1M context)' },
+            { id: 'qwen3.7-max', name: 'Qwen3.7-Max', description: 'Previous flagship for complex coding and reasoning' },
             { id: 'qwen3.7-plus', name: 'Qwen3.7-Plus', description: 'Balanced quality, speed, and price (1M context)' },
-            { id: 'qwen3.6-flash', name: 'Qwen3.6-Flash', description: 'Low-latency, low-cost multimodal model' },
+            { id: 'qwen3.6-flash', name: 'Qwen3.6-Flash', description: 'Previous low-latency, low-cost multimodal model' },
         ],
-        defaultModel: 'qwen3.7-max',
+        defaultModel: 'qwen3.8-max',
         defaultProtocol: 'openai',
         maxOutputTokens: 65_536,
         noStreamWithTools: true,
@@ -535,12 +553,17 @@ export const PROVIDERS = {
             { id: 'anthropic/claude-fable-5', name: 'Claude Fable 5', description: 'Anthropic — superseded by 5.1' },
             { id: 'anthropic/claude-opus-5', name: 'Claude Opus 5', description: 'Anthropic — flagship Opus tier' },
             { id: 'anthropic/claude-sonnet-5', name: 'Claude Sonnet 5', description: 'Anthropic — balanced' },
+            { id: 'openai/gpt-6-astra', name: 'GPT-6 Astra', description: 'OpenAI — frontier' },
             { id: 'openai/gpt-5.6-sol', name: 'GPT-5.6 Sol', description: 'OpenAI — flagship' },
             { id: 'openai/gpt-5.6-luna', name: 'GPT-5.6 Luna', description: 'OpenAI — fast/efficient' },
-            { id: 'google/gemini-3.7-flash', name: 'Gemini 3.7 Flash', description: 'Google — latest production Flash' },
-            { id: 'deepseek/deepseek-v4-pro', name: 'DeepSeek V4 Pro', description: 'DeepSeek — flagship agentic model' },
+            { id: 'google/gemini-3.8-flash', name: 'Gemini 3.8 Flash', description: 'Google — latest production Flash' },
+            { id: 'google/gemini-3.7-flash', name: 'Gemini 3.7 Flash', description: 'Google — previous production Flash' },
+            { id: 'deepseek/deepseek-v4.1-flash', name: 'DeepSeek V4.1 Flash', description: 'DeepSeek — current model' },
             { id: 'moonshotai/kimi-k3', name: 'Kimi K3', description: 'Moonshot — long-horizon coding' },
-            { id: 'qwen/qwen3.8-max', name: 'Qwen 3.8 Max', description: 'Alibaba — latest flagship' },
+            // Dated on purpose: OpenRouter lists only the snapshot. The undated
+            // `qwen/qwen3.8-max` this used to carry does not exist there, so picking
+            // it before the live catalogue loaded was an error.
+            { id: 'qwen/qwen3.8-max-0902', name: 'Qwen 3.8 Max', description: 'Alibaba — latest flagship' },
             { id: 'x-ai/grok-4.6', name: 'Grok 4.6', description: 'xAI — flagship reasoning' },
         ],
         defaultModel: 'openrouter/auto',
@@ -607,6 +630,13 @@ const RETIRED_MODEL_REPLACEMENTS = {
     google: {
         'gemini-3.1-flash-lite': 'gemini-3.5-flash-lite',
     },
+    // DeepSeek named V4.1 Flash the model to use: the V4 Flash ids are retired
+    // and served by it, and V4 Pro is routed to it from 2026-09-14.
+    deepseek: {
+        'deepseek-v4-flash': 'deepseek-flash',
+        'deepseek-v4-flash-vision-exp': 'deepseek-flash',
+        'deepseek-v4-pro': 'deepseek-flash',
+    },
     grok: {
         'grok-code-fast-1': 'grok-build-0.1',
         'grok-4-fast-reasoning': 'grok-4.3',
@@ -848,7 +878,10 @@ export function modelSupportsReasoningEffort(providerId, model) {
             // Gemini 3.x thinking_level via the OpenAI-compat reasoning_effort mapping.
             return id.startsWith('gemini-3');
         case 'deepseek':
-            return id.startsWith('deepseek-v4');
+            // `deepseek-flash` does not start with `deepseek-v4` — a prefix check
+            // alone would ship the current model with /thinking hidden, the same
+            // trap GPT-6 nearly fell into behind `gpt-5`.
+            return id.startsWith('deepseek-v4') || idMatches(id, 'deepseek-flash');
         case 'z.ai':
         case 'z.ai-api':
         case 'z.ai-cn':
@@ -908,7 +941,12 @@ export function reasoningParamsFor(providerId, model, tier) {
             // 'minimal' is deliberately not emitted: 3.7 Flash rejects it outright.
             return { reasoning_effort: tier === 'max' ? 'high' : tier };
         case 'deepseek':
-            // Graded thinking depth: high (default) or max. Lower tiers collapse to high.
+            // V4.1 Flash distinguishes low / high / max (DeepSeek's mapping table:
+            // minimal+low→low, medium+high+xhigh→high, max+ultra→max). The retired V4
+            // ids graded only high|max. Always an effort, never a disabled block.
+            if (idMatches(canonicalModelId(model), 'deepseek-flash')) {
+                return { reasoning_effort: tier === 'low' ? 'low' : tier === 'max' ? 'max' : 'high' };
+            }
             return { reasoning_effort: tier === 'max' ? 'max' : 'high' };
         case 'z.ai':
         case 'z.ai-api':
@@ -959,7 +997,9 @@ export function availableReasoningTiers(providerId, model) {
             // coding, so collapsing it hid the setting most users want.
             return ['auto', 'low', 'medium', 'high'];
         case 'deepseek':
-            return ['auto', 'high', 'max'];
+            return idMatches(canonicalModelId(model), 'deepseek-flash')
+                ? ['auto', 'low', 'high', 'max']
+                : ['auto', 'high', 'max'];
         case 'z.ai':
         case 'z.ai-api':
         case 'z.ai-cn':

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

@@ -1,11 +1,24 @@
 /**
- * Single source of truth for Codeep slash commands.
+ * Single source of truth for Codeep's TUI 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.
+ * The `/` autocomplete in `App.ts` and alias resolution in the dispatcher
+ * (`commands.ts`) derive from this registry. Adding a command means:
+ *
+ * 1. an entry in `COMMANDS` below;
+ * 2. a handler — a `case` in `renderer/commands.ts`, a `case` in `App.ts`, or
+ *    a built-in skill of the same name;
+ * 3. a row in `HELP_LAYOUT` at the bottom of this file;
+ * 4. `npm run export:commands`, which regenerates the website's command
+ *    reference (`Codeep-web/src/data/commands.json`) from this file.
+ *
+ * `registry.test.ts` fails if 2 or 3 is missed: a command offered in the
+ * autocomplete with no handler answers "Unknown command" (this is how
+ * `/account` shipped broken), and one missing from `HELP_LAYOUT` is invisible
+ * in `/help` and on the website.
+ *
+ * The ACP server (VS Code, Zed) is NOT derived from here: it keeps its own
+ * `AVAILABLE_COMMANDS` list in `acp/server.ts` and resolves its own aliases,
+ * so a command added here is not automatically offered to editors.
  *
  * ## What lives here vs. elsewhere
  *
@@ -76,7 +89,11 @@ export declare const ALL_ALIASES: ReadonlySet<string>;
 export interface HelpItemSpec {
     /** Visible key in `/help`, including the leading `/`. */
     key: string;
+    /** One line, sized for the terminal. */
     description: string;
+    /** Longer explanation used on the website's command reference instead of
+     *  `description`, where a terminal row is too short to say what matters. */
+    web?: string;
 }
 export interface HelpCategorySpec {
     title: string;

package/dist/renderer/commands/registry.js

@@ -1,11 +1,24 @@
 /**
- * Single source of truth for Codeep slash commands.
+ * Single source of truth for Codeep's TUI 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.
+ * The `/` autocomplete in `App.ts` and alias resolution in the dispatcher
+ * (`commands.ts`) derive from this registry. Adding a command means:
+ *
+ * 1. an entry in `COMMANDS` below;
+ * 2. a handler — a `case` in `renderer/commands.ts`, a `case` in `App.ts`, or
+ *    a built-in skill of the same name;
+ * 3. a row in `HELP_LAYOUT` at the bottom of this file;
+ * 4. `npm run export:commands`, which regenerates the website's command
+ *    reference (`Codeep-web/src/data/commands.json`) from this file.
+ *
+ * `registry.test.ts` fails if 2 or 3 is missed: a command offered in the
+ * autocomplete with no handler answers "Unknown command" (this is how
+ * `/account` shipped broken), and one missing from `HELP_LAYOUT` is invisible
+ * in `/help` and on the website.
+ *
+ * The ACP server (VS Code, Zed) is NOT derived from here: it keeps its own
+ * `AVAILABLE_COMMANDS` list in `acp/server.ts` and resolves its own aliases,
+ * so a command added here is not automatically offered to editors.
  *
  * ## What lives here vs. elsewhere
  *
@@ -67,13 +80,12 @@ export const COMMANDS = [
     { name: 'settings', description: 'Open settings', category: 'general' },
     { name: 'version', description: 'Show version', category: 'general' },
     { name: 'update', description: 'Check for updates', category: 'general' },
-    {
-        name: 'cost',
-        aliases: ['stats'],
-        description: 'Token usage & cost this session',
-        category: 'general',
-        aliasListed: true,
-    },
+    { name: 'cost', description: 'Token usage & cost this session', category: 'general' },
+    // Its own command, not an alias of /cost. From 2026-06-24 it was
+    // `aliases: ['stats']` on /cost, and the dispatcher resolves aliases before
+    // the switch — so /stats printed the /cost report and its own handler (per-
+    // model breakdown, cache summary, pricing table) never ran.
+    { name: 'stats', description: 'Detailed session view — per-model breakdown, cache, and pricing table', category: 'general' },
     { name: 'clear', description: 'Clear chat', category: 'general', hidden: true },
     { name: 'exit', description: 'Quit application', category: 'general', hidden: true },
     // ── sessions ───────────────────────────────────────────────────────────────
@@ -220,7 +232,7 @@ export const COMMANDS = [
     { name: 'commands', description: 'List custom slash commands in .codeep/commands/*.md', category: 'extensions' },
     { name: 'web-cache', aliases: ['webcache'], description: 'Show @web fetch cache stats (alias: /web-cache clear)', category: 'extensions' },
     // ── cloud & account ────────────────────────────────────────────────────────
-    { name: 'account', description: 'Link this machine to your codeep.dev account', category: 'cloud' },
+    { name: 'account', description: 'Show whether this machine is linked to codeep.dev, and how to link it', category: 'cloud' },
     { name: 'tasks', description: 'List/add/done/delete codeep.dev tasks', category: 'cloud', usage: ['add <title> [--bug|--feature]'] },
     { name: 'sync', description: 'Sync learning preferences and profiles to codeep.dev', category: 'cloud' },
     { name: 'telemetry', description: 'Show or toggle automatic cloud telemetry (on/off)', category: 'cloud' },
@@ -229,7 +241,11 @@ export const COMMANDS = [
     { name: 'context-save', description: 'Save conversation', category: 'cloud', hidden: true },
     { name: 'context-load', description: 'Load conversation', category: 'cloud', hidden: true },
     { name: 'context-clear', description: 'Clear saved context', category: 'cloud', hidden: true },
-    { name: 'save', description: 'Save current session', category: 'cloud', hidden: true },
+    // ACP-only. acp/commands.ts handles /save (an editor has no autosave); the TUI
+    // saves sessions on its own and has no handler, so this stays hidden — offering
+    // it in the terminal would only answer "Unknown command". Registered because
+    // registry.test.ts requires every ACP case label to be.
+    { name: 'save', description: 'Save current session (VS Code / Zed only)', category: 'cloud', hidden: true },
     // ── code generation ────────────────────────────────────────────────────────
     { name: 'build', description: 'Build the project', category: 'codegen' },
     { name: 'deploy', description: 'Build and deploy', category: 'codegen' },
@@ -333,7 +349,10 @@ export const HELP_LAYOUT = [
             { key: '/settings', description: 'Open settings' },
             { key: '/version', description: 'Show version' },
             { key: '/update', description: 'Check for updates' },
-            { key: '/stats (/cost)', description: 'Token usage & cost this session' },
+            { key: '/cost', description: 'Token usage & cost this session',
+                web: 'Token usage and estimated cost this session, per provider and model, with prompt-cache savings' },
+            { key: '/stats', description: 'Detailed view — per-model breakdown, cache, pricing table',
+                web: 'Detailed session view — per-model breakdown, plan-aware totals, prompt-cache reads and writes, and the per-1M pricing table' },
             { key: '/clear', description: 'Clear chat' },
             { key: '/exit', description: 'Quit application' },
         ],
@@ -345,11 +364,15 @@ export const HELP_LAYOUT = [
             { key: '/new', description: 'Start new session' },
             { key: '/rename <name>', description: 'Rename current session' },
             { key: '/search <term>', description: 'Search the current session' },
-            { key: '/recall <query>', description: 'Search across ALL saved sessions (cross-session)' },
-            { key: '/recall … --resume', description: 'Load the top-matching session directly' },
+            { key: '/recall <query>', description: 'Search across ALL saved sessions (cross-session)',
+                web: 'Search across all saved sessions, ranked by relevance and recency' },
+            { key: '/recall … --resume', description: 'Load the top-matching session directly',
+                web: 'Load the top-matching session directly, skipping the picker' },
             { key: '/recall … --summarize', description: 'LLM recap of what you did across matches' },
+            { key: '/cloud', description: 'List and resume sessions synced from other devices' },
             { key: '/export [md|json|txt]', description: 'Export chat' },
-            { key: '/compact [keepN]', description: 'AI-summarize older messages to free up context (keeps last N)' },
+            { key: '/compact [keepN]', description: 'AI-summarize older messages to free up context (keeps last N)',
+                web: 'AI-summarize older messages to free up context, keeping the last N (default 4)' },
         ],
     },
     {
@@ -357,7 +380,8 @@ export const HELP_LAYOUT = [
         items: [
             { key: '/checkpoint [name]', description: 'Snapshot conversation + provider/model + git HEAD' },
             { key: '/checkpoints', description: 'List saved checkpoints in this workspace' },
-            { key: '/rewind <id>', description: 'Restore conversation from a checkpoint' },
+            { key: '/rewind <id>', description: 'Restore conversation from a checkpoint',
+                web: 'Restore a checkpoint — conversation and provider/model; files roll back via the git command printed afterwards' },
             { key: '/checkpoint delete <id>', description: 'Delete a saved checkpoint' },
         ],
     },
@@ -387,6 +411,9 @@ export const HELP_LAYOUT = [
             { key: '/amend', description: 'Amend last commit' },
             { key: '/branch', description: 'Create/manage branches' },
             { key: '/stash', description: 'Stash changes' },
+            { key: '/unstash', description: 'Apply and drop the most recent stash' },
+            { key: '/pr', description: 'Create a pull request description' },
+            { key: '/changelog', description: 'Generate changelog from recent commits' },
             { key: '/init', description: 'Initialize project (.codeep/ folder)' },
             { key: '/scan', description: 'Scan project structure' },
             { key: '/memory <note>', description: 'Add note to project intelligence' },
@@ -414,19 +441,58 @@ export const HELP_LAYOUT = [
         title: 'Skills (Shortcuts)',
         items: [
             { key: '/test (/t)', description: 'Generate/run tests' },
+            { key: '/test-fix', description: 'Fix failing tests' },
+            { key: '/coverage', description: 'Run/analyze test coverage' },
+            { key: '/e2e', description: 'Generate end-to-end tests' },
+            { key: '/mock', description: 'Generate mock data for testing' },
             { key: '/docs (/d)', description: 'Open web docs for a command' },
+            { key: '/readme', description: 'Generate or update README' },
+            { key: '/api-docs', description: 'Generate API documentation' },
             { key: '/refactor (/r)', description: 'Improve code quality' },
             { key: '/fix (/f)', description: 'Debug and fix issues' },
             { key: '/explain (/e)', description: 'Explain code' },
             { key: '/optimize (/o)', description: 'Optimize performance' },
             { key: '/debug (/b)', description: 'Debug problems' },
             { key: '/security', description: 'Security audit (SQLi, XSS, secrets, auth)' },
-            { key: '/coverage', description: 'Run/analyze test coverage' },
+            { key: '/types', description: 'Add or improve TypeScript types' },
+            { key: '/cleanup', description: 'Clean up code (remove unused, format)' },
+            { key: '/modernize', description: 'Update code to use modern syntax' },
+            { key: '/migrate', description: 'Migrate code to newer version' },
+            { key: '/split', description: 'Split a large file into smaller modules' },
+            { key: '/log', description: 'Add logging to code' },
+            { key: '/translate', description: 'Translate code comments to English' },
+            { key: '/skills', description: 'List all skills' },
+            { key: '/skills <query>', description: 'Search skills by keyword' },
+            { key: '/skills bundles', description: 'List skill bundles (project + global)' },
+            { key: '/skills create-bundle <name>', description: 'Scaffold a bundle in .codeep/skills/' },
+            { key: '/skills show <name>', description: "Print a bundle's SKILL.md" },
+            { key: '/skills browse [query]', description: 'Search the marketplace at codeep.dev/skills' },
+            { key: '/skills install <owner>/<slug>', description: 'Install a marketplace bundle into the project' },
+            { key: '/skills publish <name> [--public]', description: 'Share a bundle to codeep.dev' },
+            { key: '/skills unpublish <owner>/<slug>', description: 'Remove a bundle you published' },
+        ],
+    },
+    {
+        title: 'Code Generation',
+        items: [
             { key: '/component <name>', description: 'Generate UI component' },
             { key: '/api <name>', description: 'Generate API endpoint' },
+            { key: '/hook', description: 'Generate a React hook' },
+            { key: '/service', description: 'Generate a service/utility module' },
+            { key: '/page', description: 'Generate a new page/route' },
+            { key: '/form', description: 'Generate a form with validation' },
+            { key: '/crud', description: 'Generate full CRUD for an entity' },
             { key: '/docker', description: 'Generate Dockerfile + compose' },
-            { key: '/skills', description: 'List all 50+ skills' },
-            { key: '/skills <query>', description: 'Search skills by keyword' },
+            { key: '/ci', description: 'Generate CI/CD configuration' },
+            { key: '/env', description: 'Setup environment configuration' },
+            { key: '/k8s', description: 'Generate Kubernetes manifests' },
+            { key: '/terraform', description: 'Generate Terraform configuration' },
+            { key: '/nginx', description: 'Generate Nginx configuration' },
+            { key: '/monitor', description: 'Add monitoring and observability' },
+            { key: '/build', description: 'Build the project' },
+            { key: '/deploy', description: 'Build and deploy' },
+            { key: '/release', description: 'Create a new release' },
+            { key: '/publish', description: 'Publish package to npm' },
         ],
     },
     {
@@ -441,16 +507,33 @@ export const HELP_LAYOUT = [
             { key: '/login', description: 'Login with API key' },
             { key: '/logout', description: 'Logout from provider' },
             { key: '/profile save <name>', description: 'Save current provider+model as profile' },
+            { key: '/profile load <name>', description: 'Load a saved profile' },
             { key: '/profile list', description: 'List saved profiles' },
-            { key: '/openrouter', description: 'OpenRouter routing prefs (prefer/ignore providers, fallbacks, privacy)' },
+            { key: '/profile delete <name>', description: 'Delete a saved profile' },
+            { key: '/openrouter', description: 'OpenRouter routing prefs (prefer/ignore providers, fallbacks, privacy)',
+                web: 'OpenRouter routing preferences: show, prefer or ignore upstream providers, fallbacks on/off, privacy strict/allow, clear' },
             { key: '/personality', description: 'List personalities and custom bots with model, tools, and scope' },
             { key: '/personality <name>', description: 'Activate a personality or custom bot. /personality off to clear.' },
-            { key: '/me', description: 'Your user profile (reply language, style, stack) — adapts the agent to you' },
+            { key: '/me', description: 'Your user profile (reply language, style, stack) — adapts the agent to you',
+                web: 'Your user profile — reply language, style, stack — injected into every run on every surface' },
             { key: '/me init [project]', description: 'Scaffold a profile template (global, or for this project). /me off to disable' },
             { key: '/me learn [on|off]', description: 'Learn durable prefs from this session now; on/off toggles auto-learn. /me forget clears it' },
             { key: '/me sync', description: 'Push your profile to the codeep.dev dashboard (and pull on a fresh machine)' },
-            { key: '/agents', description: 'List sub-agents the agent can delegate to (researcher / reviewer / tester / your own)' },
+            { key: '/agents', description: 'List sub-agents the agent can delegate to (researcher / reviewer / tester / your own)',
+                web: 'List the sub-agents the agent can delegate to — planner, researcher, reviewer, tester, or your own in .codeep/agents/' },
             { key: '/insights [--days N]', description: 'Activity summary — runs, files, tools, projects over the last N days (default 7)' },
+            { key: '/telegram', description: 'Set up answering confirmations on your phone' },
+            { key: '/telegram on|off', description: 'Turn Telegram approvals on or off' },
+            { key: '/audit', description: 'What agents did here — runs, tools, and what the boundary refused' },
+            { key: '/audit on|off', description: 'Turn the project audit record on or off' },
+        ],
+    },
+    {
+        title: 'Thinking',
+        items: [
+            { key: '/thinking (/effort)', description: 'Show the thinking tier and what this model supports' },
+            { key: '/thinking <auto|low|medium|high|max>', description: 'Set how hard the model reasons',
+                web: "Set the reasoning-effort tier. Auto uses each model's own default; other tiers are clamped to the levels the current provider and model actually distinguish, so an unsupported value is never sent. Models with no graded control ignore it." },
         ],
     },
     {
@@ -468,6 +551,25 @@ export const HELP_LAYOUT = [
             { key: '/mcp prompt <server> <name>', description: 'Materialize a prompt with arguments (key=value)' },
             { key: '/hooks', description: 'List installed lifecycle hooks (.codeep/hooks/<event>.sh)' },
             { key: '/commands', description: 'List custom slash commands (.codeep/commands/*.md)' },
+            { key: '/web-cache', description: 'Show @web fetch cache stats' },
+            { key: '/web-cache clear', description: 'Clear the @web fetch cache' },
+        ],
+    },
+    {
+        title: 'Cloud & Account',
+        items: [
+            { key: '/account', description: 'Is this machine linked to codeep.dev? How to link it',
+                web: 'Show whether this machine is linked to codeep.dev. Linking runs in your shell as `codeep account`, and the approval link it prints can be opened on any device where you are already signed in' },
+            { key: '/tasks', description: 'List codeep.dev tasks' },
+            { key: '/tasks add <title> [--bug|--feature] [--desc <text>]', description: 'Create a task on the dashboard' },
+            { key: '/tasks done <n>', description: 'Mark task #n as done' },
+            { key: '/tasks delete <n>', description: 'Delete task #n' },
+            { key: '/sync', description: 'Sync learning preferences and profiles to codeep.dev' },
+            { key: '/sync learning', description: 'Sync only learning preferences' },
+            { key: '/sync profiles', description: 'Sync only saved profiles' },
+            { key: '/telemetry [on|off]', description: 'Show or toggle automatic cloud telemetry' },
+            { key: '/keysync [on|off]', description: 'Show or toggle syncing API keys to codeep.dev',
+                web: 'Show or toggle syncing API keys to codeep.dev. Off by default — keys stay in your OS keychain unless you opt in' },
         ],
     },
     {

package/dist/renderer/commands.js

@@ -288,7 +288,6 @@ export async function handleCommand(command, args, ctx) {
             }
             break;
         }
-        case 'effort':
         case 'thinking': {
             const providerId = config.get('provider');
             const model = config.get('model');
@@ -302,7 +301,7 @@ export async function handleCommand(command, args, ctx) {
                     ctx.app.notify('Thinking effort: auto — each model uses its own default.');
                 }
                 else if (!supported) {
-                    ctx.app.notify(`Thinking effort set to "${sub}", but ${model} has no graded thinking control — it will be ignored until you switch to a model that does (e.g. Opus 5, GPT-5.x, Gemini 3, DeepSeek V4, Kimi K3).`);
+                    ctx.app.notify(`Thinking effort set to "${sub}", but ${model} has no graded thinking control — it will be ignored until you switch to a model that does (e.g. Opus 5, GPT-5.x or GPT-6, Gemini 3, DeepSeek V4.1 Flash, GLM-5.x, Kimi K3).`);
                 }
                 else {
                     // Tell the user what THIS model will actually run (the tier may
@@ -377,7 +376,6 @@ export async function handleCommand(command, args, ctx) {
             runAgentTask(args.join(' '), true, ctx, () => null, () => { });
             break;
         }
-        case 'd':
         case 'docs': {
             // Open per-command web docs in the system browser. Lets the inline
             // /help stay terse (single-line entries) while users who want the
@@ -1771,21 +1769,13 @@ Format: use headers per category, only include categories where you found issues
             break;
         }
         // Built-in skill shortcuts
-        case 'c':
         case 'commit':
-        case 't':
         case 'test':
-        case 'r':
         case 'refactor':
-        case 'f':
         case 'fix':
-        case 'e':
         case 'explain':
-        case 'o':
         case 'optimize':
-        case 'b':
         case 'debug':
-        case 'p':
         case 'push':
         case 'pull':
         case 'amend':
@@ -2025,6 +2015,23 @@ Describe what this skill does. The agent reads this body verbatim when it invoke
             });
             break;
         }
+        case 'account': {
+            // Linking cannot run here: `codeep account` prints to stdout and exits the
+            // process when it finishes, which would tear down the TUI. Before this
+            // case existed the autocomplete offered /account and it answered
+            // "Unknown command" — so this says where the flow runs, and what state
+            // the machine is in now.
+            const { getSyncToken, getGithubId } = await import('../config/index.js');
+            const linked = Boolean(getSyncToken());
+            const githubId = getGithubId();
+            ctx.app.addMessage({
+                role: 'system',
+                content: linked
+                    ? `## codeep.dev account\n\nThis machine is **linked**${githubId ? ` (GitHub id ${githubId})` : ''}. Usage and sessions sync to your dashboard.\n\nTo cut it off, use **Settings → Connected devices** on codeep.dev.`
+                    : `## codeep.dev account\n\nThis machine is **not linked**.\n\nQuit Codeep and run this in your shell:\n\n\`\`\`bash\ncodeep account\n\`\`\`\n\nIt prints a one-time approval link. You can open it on **any** device where you are already signed in to codeep.dev — it does not have to be this machine, so there is no need to sign in to GitHub here.`,
+            });
+            break;
+        }
         case 'tasks': {
             const { fetchTasks, markTaskDone, generateProjectId } = await import('../utils/codeepCloud.js');
             const { setTaskContext, clearTaskContext } = await import('../utils/taskContext.js');

package/dist/utils/tokenTracker.js

@@ -30,6 +30,7 @@ const MODEL_CONTEXT_WINDOWS = {
     'claude-sonnet-5': 1_000_000,
     'claude-haiku-4-5-20251001': 200_000,
     // DeepSeek
+    'deepseek-flash': 1_000_000,
     'deepseek-v4-pro': 1_000_000,
     'deepseek-v4-flash': 1_000_000,
     // Google
@@ -43,7 +44,7 @@ const MODEL_CONTEXT_WINDOWS = {
     // MiniMax
     'MiniMax-M3': 1_000_000,
     // Kimi (Moonshot) — 1M on K3, 256K across K2.x
-    'kimi-k3': 1_000_000,
+    'kimi-k3': 1_048_576,
     'kimi-k2.7-code': 262_144,
     'kimi-k2.7-code-highspeed': 262_144,
     'kimi-k2.6': 262_144,
@@ -59,6 +60,8 @@ const MODEL_CONTEXT_WINDOWS = {
     'grok-code-fast-1': 256_000,
     'grok-4-fast-reasoning': 2_000_000,
     // Qwen (Alibaba) — current hosted generation
+    'qwen3.8-max': 1_000_000,
+    'qwen3.8-flash': 1_000_000,
     'qwen3.7-max': 1_000_000,
     'qwen3.8-max-preview': 1_000_000,
     'qwen3.7-plus': 1_000_000,
@@ -93,10 +96,14 @@ const MODEL_PRICING = {
     'glm-5.1': { inputPer1M: 1.40, outputPer1M: 4.40 },
     'glm-5-turbo': { inputPer1M: 1.20, outputPer1M: 4.00 },
     // OpenAI
-    // Twice the price of 5.6 Sol. Cached reads are $1.00/M — 0.1x input, which is
+    // 2.5x 5.6 Sol at its current promotional rate. Cached reads are $1.00/M — 0.1x input, which is
     // what DEFAULT_CACHE_READ_RATE already applies, so no model row is needed.
     'gpt-6-astra': { inputPer1M: 10.00, outputPer1M: 50.00 },
-    'gpt-5.6-sol': { inputPer1M: 5.00, outputPer1M: 30.00 },
+    // Promotional rate "available at least through 2026-11-21" per OpenAI's
+    // pricing page. Carried because it is what users are billed now, and no end
+    // date is written ahead of time — the Sonnet 5 lesson. Long-context requests
+    // bill 8/30; like every row here this holds the standard short-context tier.
+    'gpt-5.6-sol': { inputPer1M: 4.00, outputPer1M: 20.00 },
     'gpt-5.6-terra': { inputPer1M: 2.00, outputPer1M: 12.00 },
     'gpt-5.6-luna': { inputPer1M: 0.20, outputPer1M: 1.20 },
     'gpt-5.5': { inputPer1M: 5.00, outputPer1M: 30.00 },
@@ -116,8 +123,19 @@ const MODEL_PRICING = {
     // honest direction for a cost estimate, and rule 5 of the catalogue policy
     // allows a clearly-labelled conservative approximation but never an invented
     // number. Cache-miss input; cache hits are ~1/50th and not modelled here.
-    'deepseek-v4-pro': { inputPer1M: 0.435, outputPer1M: 0.87 },
-    'deepseek-v4-flash': { inputPer1M: 0.14, outputPer1M: 0.28 },
+    // DeepSeek bills peak / off-peak (off-peak is half), and this table holds one
+    // rate, so it carries PEAK — an over-estimate by design. The previous rows
+    // (0.435/0.87 and 0.14/0.28) were two to four and a half times below today's
+    // peak and so under-reported, which is the one direction this table must not
+    // err in. Cache hits cost 2% of a miss, but DeepSeek reports them as
+    // `prompt_cache_hit_tokens`, which this tracker does not read — so every input
+    // token bills at the miss rate: an over-estimate again, not a gap.
+    'deepseek-flash': { inputPer1M: 0.30, outputPer1M: 1.20 },
+    // Retired V4 Flash is served by V4.1 Flash and billed at its price.
+    'deepseek-v4-flash': { inputPer1M: 0.30, outputPer1M: 1.20 },
+    // Pro's own peak rate, right for every run until 2026-09-14; after that the id
+    // is routed to Flash, and configs holding it have been migrated away from it.
+    'deepseek-v4-pro': { inputPer1M: 1.32, outputPer1M: 3.96 },
     // Google
     // Gemini 3.6/3.7/3.8 Flash carry PROMOTIONAL rates that run through 2026-12-31
     // and are scheduled to step up to 1.50/7.50 on 2027-01-01 — revisit all three
@@ -132,7 +150,10 @@ const MODEL_PRICING = {
     'gemini-3.5-flash-lite': { inputPer1M: 0.30, outputPer1M: 2.50 },
     'gemini-3-flash-preview': { inputPer1M: 0.50, outputPer1M: 3.00 },
     // MiniMax
-    'MiniMax-M3': { inputPer1M: 0.60, outputPer1M: 2.40 },
+    // "Permanent 50% off" list price for prompts up to 512K tokens; above that,
+    // 0.60/2.40. The old 0.60/2.40 row was the long-context tier and doubled the
+    // estimate for virtually every real request.
+    'MiniMax-M3': { inputPer1M: 0.30, outputPer1M: 1.20 },
     // Kimi (Moonshot) — pay-per-use cache-miss rates; `kimi-for-coding` is the
     // subscription alias (flat-fee in reality, priced notionally like K2.7 Code).
     'kimi-k3': { inputPer1M: 3.00, outputPer1M: 15.00 },
@@ -160,6 +181,8 @@ const MODEL_PRICING = {
     // `qwen3.8-max-preview` is Token-Plan-only (credit-metered, promotional
     // preview rate); Alibaba publishes no pay-per-use per-token price for it.
     // Leave it unpriced rather than borrowing the GA qwen3.8-max rate.
+    'qwen3.8-max': { inputPer1M: 2.00, outputPer1M: 6.00 },
+    'qwen3.8-flash': { inputPer1M: 0.15, outputPer1M: 0.47 },
     'qwen3.7-max': { inputPer1M: 2.50, outputPer1M: 7.50 },
     'qwen3.7-plus': { inputPer1M: 0.40, outputPer1M: 1.60 },
     'qwen3.6-plus': { inputPer1M: 0.40, outputPer1M: 2.40 },

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "3.2.2";
+export declare const VERSION = "3.3.1";

package/dist/version.js

@@ -1,4 +1,4 @@
 // AUTO-GENERATED by scripts/gen-version.js — do not edit by hand.
 // Baked from package.json at build time so the bun-compiled binary reports
 // the right version (it has no package.json on disk to read at runtime).
-export const VERSION = '3.2.2';
+export const VERSION = '3.3.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeep",
-  "version": "3.2.2",
+  "version": "3.3.1",
   "description": "AI-powered coding assistant built for the terminal. Multiple LLM providers, project-aware context, and a seamless development workflow.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,6 +17,7 @@
     "test:coverage": "vitest run --coverage",
     "version": "node scripts/gen-version.js && git add src/version.ts",
     "export:catalogue": "node --import tsx scripts/export-catalogue.ts",
+    "export:commands": "node --import tsx scripts/export-commands.ts",
     "release": "node scripts/release.js"
   },
   "repository": {