codeep 2.9.0 → 2.11.0

package/README.md

@@ -346,7 +346,7 @@ Run `/agents` to list them. The agent invokes them itself via the `delegate` too
 name: migrator
 description: Writes and runs database migrations
 tools: [read_file, write_file, edit_file, execute_command]   # allowlist; omit = all
-model: glm-5.1            # optional override
+model: glm-5.2[1m]        # optional override
 personality: senior-reviewer   # optional preset
 maxIterations: 12         # optional budget
 ---
@@ -1007,14 +1007,14 @@ After installation, `codeep` is available globally in your terminal. Simply run
 **Model favorites** — save provider+model combos and switch instantly:
 ```
 > /provider      # switch to z.ai
-> /model glm-5.1
+> /model glm-5.2[1m]
 > /profile save fast
 
 > /provider      # switch to openai
 > /model gpt-4.1
 > /profile save work
 
-> /model fast    # instantly switch to z.ai / glm-5.1
+> /model fast    # instantly switch to z.ai / glm-5.2
 > /model work    # instantly switch to openai / gpt-4.1
 ```
 

package/dist/acp/commands.js

@@ -2,7 +2,7 @@
 // Slash command handler for ACP sessions.
 // Mirrors CLI commands from renderer/commands.ts but returns plain text
 // responses (no TUI) suitable for streaming back via session/update.
-import { config, getCurrentProvider, getModelsForCurrentProvider, setProvider, setApiKey, isConfigured, listSessionsWithInfo, startNewSession, loadSession, saveSession, initializeAsProject, isManuallyInitializedProject, setProjectPermission, hasWritePermission, hasReadPermission, isTelemetryEnabled, telemetryForcedOffByEnv, } from '../config/index.js';
+import { config, getCurrentProvider, getModelsForCurrentProvider, setProvider, setApiKey, isConfigured, listSessionsWithInfo, startNewSession, loadSession, saveSession, initializeAsProject, isManuallyInitializedProject, setProjectPermission, hasWritePermission, hasReadPermission, isTelemetryEnabled, telemetryForcedOffByEnv, isKeySyncEnabled, keySyncForcedOffByEnv, } from '../config/index.js';
 import { getProviderList, getProvider } from '../config/providers.js';
 import { getProjectContext } from '../utils/project.js';
 import { loadCustomCommands } from '../utils/customCommands.js';
@@ -237,6 +237,34 @@ export async function handleCommand(input, session, onChunk, abortSignal) {
             lines.push('', 'Toggle with `/telemetry on` | `/telemetry off`. Controls automatic uploads of usage stats, session transcripts, progress, and memory notes.');
             return { handled: true, response: lines.join('\n') };
         }
+        case 'keysync': {
+            const sub = args[0]?.toLowerCase();
+            const envOff = keySyncForcedOffByEnv();
+            if (sub === 'on' || sub === 'off') {
+                if (envOff) {
+                    return { handled: true, response: 'Cloud key sync is forced **off** by the `CODEEP_NO_KEY_SYNC` env var — unset it to change this. The config flag can\'t override an env var.' };
+                }
+                config.set('syncKeysToCloud', sub === 'on');
+                return {
+                    handled: true,
+                    response: sub === 'on'
+                        ? 'Cloud key sync **on** — `codeep account push`/`sync` will now upload/download API keys. Note: synced keys are stored server-readable on codeep.dev.'
+                        : 'Cloud key sync **off** — API keys stay in your OS keychain only. (`codeep account purge-keys` wipes any keys already on the server.)',
+                };
+            }
+            if (sub && sub !== 'status') {
+                return { handled: true, response: 'Usage: `/keysync` · `/keysync on` · `/keysync off`' };
+            }
+            const flag = config.get('syncKeysToCloud') === true;
+            const lines = [
+                `**Cloud key sync:** ${isKeySyncEnabled() ? 'on' : 'off'}`,
+                `- Config flag \`syncKeysToCloud\`: ${flag}`,
+            ];
+            if (envOff)
+                lines.push('- Forced **off** by `CODEEP_NO_KEY_SYNC` (env overrides the flag).');
+            lines.push('', 'OFF by default — API keys live only in your OS keychain unless enabled. When on, `codeep account push`/`sync` move keys, stored **server-readable** on codeep.dev.');
+            return { handled: true, response: lines.join('\n') };
+        }
         case 'login': {
             const [providerId, apiKey] = args;
             if (!providerId || !apiKey) {

package/dist/acp/protocol.d.ts

@@ -102,6 +102,10 @@ export interface SessionNewParams {
 }
 export interface SessionNewResult {
     sessionId: string;
+    history?: {
+        role: string;
+        content: string;
+    }[];
     modes?: SessionModeState | null;
     configOptions?: SessionConfigOption[] | null;
 }

package/dist/acp/server.js

@@ -67,6 +67,9 @@ const AVAILABLE_COMMANDS = [
     { name: 'learn', description: 'Learn coding preferences from project files' },
     { name: 'memory', description: 'Project memory notes — add / list / remove / clear', input: { hint: '<note> | list | remove <n> | clear' } },
     { name: 'profile', description: 'Save / load / delete provider+model presets', input: { hint: 'save | load | delete | list | <name>' } },
+    // Privacy toggles
+    { name: 'telemetry', description: 'Show or toggle automatic cloud telemetry', input: { hint: '[on|off]' } },
+    { name: 'keysync', description: 'Show or toggle syncing API keys to codeep.dev (off by default)', input: { hint: '[on|off]' } },
     // Skills + custom commands
     { name: 'skills', description: 'List/create/share skill bundles. Subcommands: bundles, create-bundle, show, publish, install, browse, unpublish', input: { hint: '[query] | bundles | create-bundle <name> | show <name> | publish <slug> [--public] | install <owner>/<slug> | browse [q] | unpublish <owner>/<slug>' } },
     { name: 'commands', description: 'List user-authored commands from .codeep/commands/*.md' },
@@ -549,6 +552,10 @@ export function startAcpServer() {
         });
         const result = {
             sessionId: acpSessionId,
+            // On a resume (fresh=false) `history` holds the prior transcript;
+            // return it (user/assistant only) so a reconnected client can repaint
+            // the chat. Empty on a fresh session, so this is harmless there.
+            history: history.filter(m => m.role === 'user' || m.role === 'assistant'),
             modes: AGENT_MODES,
             configOptions: buildConfigOptions(),
         };

package/dist/config/index.d.ts

@@ -47,6 +47,9 @@ interface ConfigSchema {
      *  can't execute shell on first tool call). Granted via `/hooks trust`. */
     trustedHookProjects: string[];
     currentSessionId: string;
+    /** Highest one-shot config migration applied (see the migration block
+     *  after config creation). Bump MIGRATION_VERSION when adding one. */
+    migrationVersion: number;
     temperature: number;
     maxTokens: number;
     apiTimeout: number;

package/dist/config/index.js

@@ -141,8 +141,9 @@ function isWritable(dir) {
 function createConfig() {
     const defaults = {
         apiKey: '',
+        migrationVersion: 0,
         provider: 'z.ai',
-        model: 'glm-5.1',
+        model: 'glm-5.2[1m]',
         agentMode: 'on',
         ollamaUrl: 'http://localhost:11434',
         ollamaNativeApi: false,
@@ -247,26 +248,35 @@ export const config = createConfig();
 if (config.get('agentMode') === 'auto') {
     config.set('agentMode', 'on');
 }
-// Migrate the old runaway default (10000 iterations) back down to a sane ceiling.
-// The old migration kept forcing it up, so a user who had the bad default baked
-// into their local config will still see "step X/10000" until this trims it.
-if (config.get('agentMaxIterations') >= 10000) {
-    config.set('agentMaxIterations', 50);
-}
-if (config.get('agentMaxDuration') < 480) {
-    config.set('agentMaxDuration', 480);
-}
-if (config.get('maxTokens') < 32768) {
-    config.set('maxTokens', 32768);
-}
-if (config.get('agentApiTimeout') <= 180000) {
-    config.set('agentApiTimeout', 600000);
-}
-if (config.get('rateLimitApi') <= 30) {
-    config.set('rateLimitApi', 10000);
-}
-if (config.get('rateLimitCommands') <= 100) {
-    config.set('rateLimitCommands', 10000);
+// One-shot migrations of old defaults. These used to run unconditionally on
+// EVERY startup, which silently clobbered values the user later chose in
+// /settings (e.g. maxTokens 8192 was forced back to 32768 each launch — the
+// affected sliders were effectively lies). Each migration now runs exactly
+// once per config, recorded via `migrationVersion`; after that, whatever the
+// user sets sticks. Bump MIGRATION_VERSION when adding a new one.
+const MIGRATION_VERSION = 1;
+if ((config.get('migrationVersion') ?? 0) < 1) {
+    // Migrate the old runaway default (10000 iterations) down to a sane
+    // ceiling, and old conservative defaults up to the current ones.
+    if (config.get('agentMaxIterations') >= 10000) {
+        config.set('agentMaxIterations', 50);
+    }
+    if (config.get('agentMaxDuration') < 480) {
+        config.set('agentMaxDuration', 480);
+    }
+    if (config.get('maxTokens') < 32768) {
+        config.set('maxTokens', 32768);
+    }
+    if (config.get('agentApiTimeout') <= 180000) {
+        config.set('agentApiTimeout', 600000);
+    }
+    if (config.get('rateLimitApi') <= 30) {
+        config.set('rateLimitApi', 10000);
+    }
+    if (config.get('rateLimitCommands') <= 100) {
+        config.set('rateLimitCommands', 10000);
+    }
+    config.set('migrationVersion', MIGRATION_VERSION);
 }
 // Global sessions directory - use same directory as conf package for cross-platform consistency
 // config.path gives us something like ~/.config/codeep-nodejs/config.json, we use its parent

package/dist/config/providers.js

@@ -18,11 +18,13 @@ export const PROVIDERS = {
             },
         },
         models: [
-            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Latest GLM model, available to all users' },
+            { id: 'glm-5.2[1m]', name: 'GLM-5.2 (1M)', description: 'Latest GLM model with 1M context, available to all users' },
+            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Latest GLM model, available to all users' },
+            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Previous GLM model, available to all users' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant, available to all users' },
-            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM model (Pro/Max plan only)' },
+            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM-5 model (Pro/Max plan only)' },
         ],
-        defaultModel: 'glm-5.1',
+        defaultModel: 'glm-5.2[1m]',
         defaultProtocol: 'openai',
         envKey: 'ZAI_API_KEY',
         subscribeUrl: 'https://z.ai/subscribe?ic=NXYNXZOV14',
@@ -45,11 +47,13 @@ export const PROVIDERS = {
             },
         },
         models: [
-            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Latest GLM model' },
+            { id: 'glm-5.2[1m]', name: 'GLM-5.2 (1M)', description: 'Latest GLM model with 1M context' },
+            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Latest GLM model' },
+            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Previous GLM model' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant' },
-            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM model' },
+            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM-5 model' },
         ],
-        defaultModel: 'glm-5.1',
+        defaultModel: 'glm-5.2[1m]',
         defaultProtocol: 'openai',
         envKey: 'ZAI_API_KEY',
         subscribeUrl: 'https://api.z.ai',
@@ -72,11 +76,13 @@ export const PROVIDERS = {
             },
         },
         models: [
-            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Latest GLM model, available to all users' },
+            { id: 'glm-5.2[1m]', name: 'GLM-5.2 (1M)', description: 'Latest GLM model with 1M context, available to all users' },
+            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Latest GLM model, available to all users' },
+            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Previous GLM model, available to all users' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant, available to all users' },
-            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM model (Pro/Max plan only)' },
+            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM-5 model (Pro/Max plan only)' },
         ],
-        defaultModel: 'glm-5.1',
+        defaultModel: 'glm-5.2[1m]',
         defaultProtocol: 'openai',
         envKey: 'ZAI_CN_API_KEY',
         subscribeUrl: 'https://open.bigmodel.cn/glm-coding',
@@ -99,11 +105,13 @@ export const PROVIDERS = {
             },
         },
         models: [
-            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Latest GLM model' },
+            { id: 'glm-5.2[1m]', name: 'GLM-5.2 (1M)', description: 'Latest GLM model with 1M context' },
+            { id: 'glm-5.2', name: 'GLM-5.2', description: 'Latest GLM model' },
+            { id: 'glm-5.1', name: 'GLM-5.1', description: 'Previous GLM model' },
             { id: 'glm-5-turbo', name: 'GLM-5 Turbo', description: 'Fast GLM-5 variant' },
-            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM model' },
+            { id: 'glm-5', name: 'GLM-5', description: 'Most capable GLM-5 model' },
         ],
-        defaultModel: 'glm-5.1',
+        defaultModel: 'glm-5.2[1m]',
         defaultProtocol: 'openai',
         envKey: 'ZAI_CN_API_KEY',
         subscribeUrl: 'https://open.bigmodel.cn',

package/dist/renderer/App.d.ts

@@ -40,6 +40,9 @@ export declare class App {
     private isLoading;
     private options;
     private scrollOffset;
+    /** Messages that arrived while the user was scrolled up — drives the
+     *  status bar's "↓ N new" badge; 0 whenever the view is at the bottom. */
+    private unseenWhileScrolled;
     private notification;
     private notificationIsWarn;
     private notificationTimeout;
@@ -126,7 +129,10 @@ export declare class App {
      */
     stop(): void;
     /**
-     * Add a message
+     * Add a message. Autoscrolls only when the user is already at the
+     * bottom — if they scrolled up to read something, new messages must
+     * not yank the view away; the status bar shows a "↓ N new" badge
+     * instead (cleared when they return to the bottom).
      */
     addMessage(message: Message): void;
     setMessages(messages: Message[]): void;

package/dist/renderer/App.js

@@ -49,6 +49,12 @@ const COMMAND_DESCRIPTIONS = {
     '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',
@@ -66,6 +72,38 @@ const COMMAND_DESCRIPTIONS = {
     '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',
@@ -74,13 +112,14 @@ const COMMAND_DESCRIPTIONS = {
     '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': 'Show pending tasks from codeep.dev dashboard',
+    '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)',
@@ -116,6 +155,9 @@ export class App {
     isLoading = false;
     options;
     scrollOffset = 0;
+    /** Messages that arrived while the user was scrolled up — drives the
+     *  status bar's "↓ N new" badge; 0 whenever the view is at the bottom. */
+    unseenWhileScrolled = 0;
     notification = '';
     notificationIsWarn = false;
     notificationTimeout = null;
@@ -216,41 +258,13 @@ export class App {
     loginCallback = null;
     // Glitch characters for intro animation
     static GLITCH_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ@#$%&*<>?/;:[]=';
-    // All available commands
-    static COMMANDS = [
-        'help', 'status', 'settings', 'version', 'update', 'clear', 'exit',
-        'sessions', 'new', 'rename', 'search', 'export',
-        'agent', 'agent-dry', 'stop', 'undo', 'undo-all', 'history', 'changes',
-        'diff', 'commit', 'git-commit', 'push', 'pull', 'scan', 'review',
-        'copy', 'paste', 'apply', 'add', 'drop',
-        'test', 'docs', 'refactor', 'fix', 'explain', 'optimize', 'debug', 'skills',
-        'amend', 'pr', 'changelog', 'branch', 'stash', 'unstash',
-        'build', 'deploy', 'release', 'publish',
-        'component', 'api', 'hook', 'service', 'page', 'form', 'crud',
-        'security', 'profile', 'log', 'types', 'cleanup', 'modernize', 'migrate',
-        'split', 'rename', 'coverage', 'e2e', 'mock', 'readme', 'translate',
-        'docker', 'ci', 'env', 'k8s', 'terraform', 'nginx', 'monitor',
-        'test-fix', 'api-docs',
-        'multiline', 'memory', 'init',
-        'provider', 'model', 'protocol', 'lang', 'grant', 'login', 'logout',
-        'context-save', 'context-load', 'context-clear', 'learn',
-        'cost', 'tasks', 'account', 'sync', 'telemetry',
-        // 2.0 — extensions, checkpoints, MCP, custom commands, OpenRouter prefs.
-        // Keep in lockstep with COMMAND_DESCRIPTIONS below and helpCategories.
-        'compact', 'commands', 'checkpoint', 'checkpoints', 'rewind',
-        'hooks', 'mcp', 'openrouter',
-        // 2.0.2 — plan mode.
-        'plan', 'go',
-        // 2.0.3 — personalities + insights.
-        'personality', 'insights',
-        // 2.1.0 — cross-session recall.
-        'recall',
-        // 2.2.0 — user profile.
-        'me',
-        // 2.3.0 — sub-agents / delegation.
-        'agents',
-        'c', 't', 'd', 'r', 'f', 'e', 'o', 'b', 'p',
-    ];
+    // The `/` autocomplete list, derived from COMMAND_DESCRIPTIONS so it IS
+    // the registry — a command can no longer ship without a description (a
+    // hand-maintained parallel array drifted to 48 blank rows over time).
+    // Single-letter shortcuts (c, t, d, r, f, e, o, b, p) stay routable in
+    // commands.ts but are deliberately not listed: they alias commands that
+    // already appear, and bare one-letter rows just cluttered the dropdown.
+    static COMMANDS = Object.keys(COMMAND_DESCRIPTIONS);
     constructor(options) {
         this.screen = new Screen();
         this.input = new Input();
@@ -283,24 +297,34 @@ export class App {
         this.screen.cleanup();
     }
     /**
-     * Add a message
+     * Add a message. Autoscrolls only when the user is already at the
+     * bottom — if they scrolled up to read something, new messages must
+     * not yank the view away; the status bar shows a "↓ N new" badge
+     * instead (cleared when they return to the bottom).
      */
     addMessage(message) {
         this.messages.push(message);
         this.messageCache.push(null); // slot za novu poruku
-        this.scrollOffset = 0;
+        if (this.scrollOffset === 0) {
+            this.unseenWhileScrolled = 0;
+        }
+        else {
+            this.unseenWhileScrolled++;
+        }
         this.scheduleRender();
     }
     setMessages(messages) {
         this.messages = messages;
         this.messageCache = new Array(messages.length).fill(null);
         this.scrollOffset = 0;
+        this.unseenWhileScrolled = 0;
         this.scheduleRender();
     }
     clearMessages() {
         this.messages = [];
         this.messageCache = [];
         this.scrollOffset = 0;
+        this.unseenWhileScrolled = 0;
         this.scheduleRender();
     }
     /**
@@ -972,20 +996,15 @@ export class App {
         if (event.key === 'pagedown') {
             // Scroll down (show newer messages)
             this.scrollOffset = Math.max(0, this.scrollOffset - 10);
+            if (this.scrollOffset === 0)
+                this.unseenWhileScrolled = 0;
             this.scheduleRender();
             return;
         }
-        // Arrow up/down can also scroll when input is empty
-        if (event.key === 'up' && !this.editor.getValue() && !this.showAutocomplete) {
-            this.scrollOffset += 3;
-            this.scheduleRender();
-            return;
-        }
-        if (event.key === 'down' && !this.editor.getValue() && !this.showAutocomplete && this.scrollOffset > 0) {
-            this.scrollOffset = Math.max(0, this.scrollOffset - 3);
-            this.scheduleRender();
-            return;
-        }
+        // NOTE: ↑/↓ on an empty input deliberately fall through to the editor —
+        // that's prompt-history recall (Input.ts), which the status bar has
+        // always advertised but this handler used to shadow with a 3-line
+        // scroll. Scrolling lives on PgUp/PgDn and the mouse wheel.
         // Mouse scroll
         if (event.key === 'scrollup') {
             this.scrollOffset += 3;
@@ -994,6 +1013,8 @@ export class App {
         }
         if (event.key === 'scrolldown') {
             this.scrollOffset = Math.max(0, this.scrollOffset - 3);
+            if (this.scrollOffset === 0)
+                this.unseenWhileScrolled = 0;
             this.scheduleRender();
             return;
         }
@@ -2297,7 +2318,14 @@ export class App {
             this.screen.write(leftX, y, ' · ', fg.gray);
             this.screen.write(leftX + 3, y, tokenStr, fg.gray);
         }
-        // Right: context-sensitive hints
+        // Right: context-sensitive hints. While scrolled up, the "new
+        // messages below" badge takes priority — it's the only signal that
+        // the conversation moved on (addMessage no longer yanks the view).
+        if (this.scrollOffset > 0 && this.unseenWhileScrolled > 0) {
+            const badge = `↓ ${this.unseenWhileScrolled} new · PgDn `;
+            this.screen.write(width - badge.length, y, badge, PRIMARY_COLOR);
+            return;
+        }
         let rightText;
         if (this.isStreaming || this.isLoading) {
             rightText = 'Esc to stop ';

package/dist/renderer/commands.js

@@ -1833,11 +1833,40 @@ Describe what this skill does. The agent reads this body verbatim when it invoke
                 }
                 break;
             }
-            // /tasks add <title>  — create a new task on the dashboard
+            // /tasks add <title> [--bug | --feature] [--desc <text>]  — create a task
+            // on the dashboard. Type matches the dashboard picker (task | bug |
+            // feature); a --bug/--feature/--task flag anywhere sets it (default task).
+            // --desc/--description captures the following words (until the next flag)
+            // as the description — the same field the dashboard + macOS app set, and
+            // which the list view and the agent task-context prompt already render.
             if (subCmd === 'add') {
-                const title = args.slice(1).join(' ').trim();
+                const TASK_TYPES = ['task', 'bug', 'feature'];
+                let type = 'task';
+                const titleWords = [];
+                const descWords = [];
+                let capturingDesc = false;
+                for (const w of args.slice(1)) {
+                    const flag = /^--([\w-]+)$/.exec(w);
+                    if (flag) {
+                        const name = flag[1].toLowerCase();
+                        if (name === 'desc' || name === 'description') {
+                            capturingDesc = true;
+                            continue;
+                        }
+                        if (TASK_TYPES.includes(name))
+                            type = name;
+                        capturingDesc = false; // any non-desc flag ends description capture
+                        continue;
+                    }
+                    if (capturingDesc)
+                        descWords.push(w);
+                    else
+                        titleWords.push(w);
+                }
+                const title = titleWords.join(' ').trim();
+                const description = descWords.join(' ').trim();
                 if (!title) {
-                    ctx.app.notify('Usage: /tasks add <title>');
+                    ctx.app.notify('Usage: /tasks add <title> [--bug | --feature] [--desc <text>]');
                     break;
                 }
                 const projectName = ctx.projectContext?.name;
@@ -1852,10 +1881,10 @@ Describe what this skill does. The agent reads this body verbatim when it invoke
                     const res = await fetch('https://codeep.dev/api/tasks', {
                         method: 'POST',
                         headers: { 'Content-Type': 'application/json', 'x-sync-token': syncToken },
-                        body: JSON.stringify({ projectName: projectName || '', projectId: projectId ?? null, title, type: 'task' }),
+                        body: JSON.stringify({ projectName: projectName || '', projectId: projectId ?? null, title, type, ...(description ? { description } : {}) }),
                     });
                     if (res.ok) {
-                        ctx.app.notify(`+ Task added: ${title}`);
+                        ctx.app.notify(`+ ${type[0].toUpperCase()}${type.slice(1)} added: ${title}`);
                     }
                     else {
                         ctx.app.notify('Failed to add task');
@@ -1884,7 +1913,10 @@ Describe what this skill does. The agent reads this body verbatim when it invoke
             const lines = [`## Tasks${projectName ? ` — ${projectName}` : ''}`, ''];
             tasks.forEach((t, i) => {
                 const icon = TYPE_ICON[t.type] ?? '[task]';
-                lines.push(`${i + 1}. ${icon} ${t.title}${t.description ? `\n   ${t.description}` : ''}`);
+                // In a global listing (not scoped to one project) tag each row with its
+                // project so a mixed list is legible — matches the macOS/web task rows.
+                const proj = !projectName && t.project_name ? ` _(${t.project_name})_` : '';
+                lines.push(`${i + 1}. ${icon} ${t.title}${proj}${t.description ? `\n   ${t.description}` : ''}`);
             });
             lines.push('', `*${tasks.length} pending task${tasks.length > 1 ? 's' : ''}. Use /tasks done <n> to mark complete.*`);
             lines.push('*Tasks loaded into agent context — agent will see them in the next message.*');
@@ -2034,9 +2066,12 @@ Describe what this skill does. The agent reads this body verbatim when it invoke
             });
             break;
         }
-        case 'stats':
-        case 'cost': {
-            const { getCostBreakdown, getSessionStats, formatTokenCount, getPricingTable } = await import('../utils/tokenTracker.js');
+        // /stats — detailed session view: per-model breakdown, total, prompt-cache
+        // summary, and the per-1M pricing reference. `/cost` is the concise sibling
+        // (formatCostReport, above); the two are intentionally distinct, so this
+        // case no longer also claims 'cost' (which always hit the handler above).
+        case 'stats': {
+            const { getCostBreakdown, getSessionStats, formatTokenCount, getPricingTable, getCacheStats } = await import('../utils/tokenTracker.js');
             const stats = getSessionStats();
             const lines = ['## Session Cost', ''];
             if (stats.requestCount === 0) {
@@ -2064,6 +2099,19 @@ Describe what this skill does. The agent reads this body verbatim when it invoke
                         lines.push(`**Total: ~$${stats.estimatedCost.toFixed(4)}**`);
                     }
                 }
+                // Prompt caching — parity with /cost (the 2.0.2 caching section was
+                // only wired into formatCostReport). Shown only when caching landed.
+                const cache = getCacheStats();
+                if (cache.cacheReadTokens > 0 || cache.cacheCreationTokens > 0) {
+                    lines.push('', '### Prompt caching');
+                    lines.push(`Cache reads: ${formatTokenCount(cache.cacheReadTokens)} tokens (billed at 0.1× input rate)`);
+                    if (cache.cacheCreationTokens > 0) {
+                        lines.push(`Cache writes: ${formatTokenCount(cache.cacheCreationTokens)} tokens (billed at 1.25× input rate)`);
+                    }
+                    if (cache.estimatedSavingsUsd > 0) {
+                        lines.push(`Estimated savings vs no caching: $${cache.estimatedSavingsUsd.toFixed(4)}`);
+                    }
+                }
                 lines.push('');
             }
             lines.push('### Pricing (per 1M tokens)');

package/dist/renderer/components/Help.d.ts

@@ -1,7 +1,6 @@
 /**
  * Help screen component
  */
-import { Screen } from '../Screen';
 export interface HelpCategory {
     title: string;
     items: Array<{
@@ -24,7 +23,3 @@ export declare const keyboardShortcuts: {
  * Get total number of help pages
  */
 export declare function getHelpTotalPages(screenHeight: number): number;
-/**
- * Render full help screen
- */
-export declare function renderHelpScreen(screen: Screen, page?: number): void;