codeep 1.3.42 → 2.0.1

package/dist/renderer/commands.js

@@ -96,6 +96,30 @@ export async function handleCommand(command, args, ctx) {
             const providerId = config.get('provider');
             const { isDynamicModelsProvider, isNoApiKeyProvider: _noKey } = await import('../config/providers.js');
             if (isDynamicModelsProvider(providerId)) {
+                if (providerId === 'openrouter') {
+                    ctx.app.notify('Fetching OpenRouter catalog…');
+                    const { fetchOpenRouterModels } = await import('../config/index.js');
+                    const apiKey = (await import('../config/index.js')).getApiKey('openrouter');
+                    const models = await fetchOpenRouterModels(apiKey || undefined);
+                    if (!models || models.length === 0) {
+                        ctx.app.notify('Could not fetch OpenRouter models (network? key?). Using built-in shortlist.');
+                        const fallback = getModelsForCurrentProvider();
+                        const currentModel = config.get('model');
+                        const modelItems = Object.keys(fallback).map(id => ({ key: id, label: fallback[id], description: '' }));
+                        ctx.app.showSelect('Select OpenRouter Model', modelItems, currentModel, (item) => {
+                            config.set('model', item.key);
+                            ctx.app.notify(`Model: ${item.key}`);
+                        });
+                        break;
+                    }
+                    const modelItems = models.map(m => ({ key: m.id, label: m.id, description: m.description }));
+                    const currentModel = config.get('model');
+                    ctx.app.showSelect(`Select OpenRouter Model (${models.length})`, modelItems, currentModel, (item) => {
+                        config.set('model', item.key);
+                        ctx.app.notify(`Model: ${item.key}`);
+                    });
+                    break;
+                }
                 const { fetchOllamaModels } = await import('../config/index.js');
                 ctx.app.notify('Fetching models from Ollama...');
                 const ollamaModels = await fetchOllamaModels();
@@ -491,7 +515,7 @@ Format: use headers per category, only include categories where you found issues
         }
         case 'login': {
             const providers = getProviderList();
-            ctx.app.showLogin(providers.map(p => ({ id: p.id, name: p.name, subscribeUrl: p.subscribeUrl, noApiKey: p.noApiKey })), async (result) => {
+            ctx.app.showLogin(providers.map(p => ({ id: p.id, name: p.name, description: p.description, subscribeUrl: p.subscribeUrl, noApiKey: p.noApiKey })), async (result) => {
                 if (result) {
                     setProvider(result.providerId);
                     await setApiKey(result.apiKey);
@@ -790,6 +814,168 @@ Format: use headers per category, only include categories where you found issues
             }).catch(() => ctx.app.notify('No changes tracked'));
             break;
         }
+        case 'cost': {
+            const { formatCostReport } = await import('../utils/tokenTracker.js');
+            ctx.app.addMessage({ role: 'system', content: formatCostReport() });
+            break;
+        }
+        case 'compact': {
+            const messages = ctx.app.getMessages();
+            const keepRecent = args[0] ? Math.max(2, parseInt(args[0], 10) || 4) : 4;
+            if (messages.length <= keepRecent + 2) {
+                ctx.app.notify(`Nothing to compact — only ${messages.length} message(s) in this session.`);
+                break;
+            }
+            ctx.app.notify(`Compacting ${messages.length - keepRecent} older message(s)…`);
+            const { compactHistory } = await import('../utils/context.js');
+            try {
+                const result = await compactHistory(messages, { keepRecent, projectContext: ctx.projectContext });
+                if (result.replaced === 0) {
+                    ctx.app.notify('Nothing to compact');
+                    break;
+                }
+                ctx.app.setMessages(result.compacted);
+                // Persist so the compacted history survives a restart.
+                saveSession(ctx.sessionId, result.compacted, ctx.projectPath);
+                ctx.app.addMessage({
+                    role: 'system',
+                    content: `# Conversation Compacted\n\nReplaced ${result.replaced} earlier message${result.replaced === 1 ? '' : 's'} with a summary. Kept the last ${keepRecent} message${keepRecent === 1 ? '' : 's'} verbatim.\n\n**Summary:**\n\n${result.summary}`,
+                });
+            }
+            catch (err) {
+                ctx.app.notify(`Compaction failed: ${err.message}`);
+            }
+            break;
+        }
+        case 'checkpoint': {
+            const sub = args[0]?.toLowerCase();
+            const { createCheckpoint, deleteCheckpoint, listCheckpoints, formatCheckpointList } = await import('../utils/checkpoints.js');
+            const { getCurrentSessionActions } = await import('../utils/agent.js');
+            if (sub === 'delete') {
+                const id = args[1];
+                if (!id) {
+                    ctx.app.notify('Usage: /checkpoint delete <id>');
+                    break;
+                }
+                ctx.app.notify(deleteCheckpoint(ctx.projectPath, id) ? `Deleted checkpoint ${id}` : `Checkpoint not found: ${id}`);
+                break;
+            }
+            if (sub === 'list') {
+                ctx.app.addMessage({ role: 'system', content: formatCheckpointList(listCheckpoints(ctx.projectPath)) });
+                break;
+            }
+            const name = args.join(' ').trim() || undefined;
+            const provider = getCurrentProvider();
+            const filesTouched = Array.from(new Set(getCurrentSessionActions()
+                .filter(a => a.target && (a.type === 'write' || a.type === 'edit' || a.type === 'delete' || a.type === 'mkdir'))
+                .map(a => a.target)));
+            const cp = createCheckpoint({
+                workspaceRoot: ctx.projectPath,
+                sessionId: ctx.sessionId,
+                provider: provider.id,
+                model: config.get('model'),
+                messages: ctx.app.getMessages(),
+                filesTouched,
+                name,
+            });
+            ctx.app.addMessage({
+                role: 'system',
+                content: `# Checkpoint created\n\n\`${cp.id}\`${cp.name ? ` — **${cp.name}**` : ''}\n\nCaptured ${cp.messages.length} message${cp.messages.length === 1 ? '' : 's'}, ${cp.filesTouched.length} file${cp.filesTouched.length === 1 ? '' : 's'} touched${cp.gitHead ? `, git \`${cp.gitHead}\`` : ''}.\n\nUse \`/rewind ${cp.id}\` to restore.`,
+            });
+            break;
+        }
+        case 'checkpoints': {
+            const { listCheckpoints, formatCheckpointList } = await import('../utils/checkpoints.js');
+            ctx.app.addMessage({ role: 'system', content: formatCheckpointList(listCheckpoints(ctx.projectPath)) });
+            break;
+        }
+        case 'openrouter': {
+            const { readOpenRouterPreferences, writeOpenRouterPreferences, formatOpenRouterPreferences } = await import('../utils/openrouterPrefs.js');
+            const sub = args[0]?.toLowerCase();
+            const current = readOpenRouterPreferences();
+            if (!sub || sub === 'show') {
+                ctx.app.addMessage({ role: 'system', content: formatOpenRouterPreferences(current) });
+                break;
+            }
+            if (sub === 'clear') {
+                writeOpenRouterPreferences(null);
+                ctx.app.notify('OpenRouter preferences cleared');
+                break;
+            }
+            if (sub === 'prefer') {
+                const list = args.slice(1).join(' ').split(',').map(s => s.trim()).filter(Boolean);
+                if (list.length === 0) {
+                    ctx.app.notify('Usage: /openrouter prefer <p1>[,<p2>...]');
+                    break;
+                }
+                writeOpenRouterPreferences({ ...current, order: list });
+                ctx.app.notify(`OpenRouter preference: ${list.join(' → ')}`);
+                break;
+            }
+            if (sub === 'ignore') {
+                const list = args.slice(1).join(' ').split(',').map(s => s.trim()).filter(Boolean);
+                if (list.length === 0) {
+                    ctx.app.notify('Usage: /openrouter ignore <p1>[,<p2>...]');
+                    break;
+                }
+                writeOpenRouterPreferences({ ...current, ignore: list });
+                ctx.app.notify(`OpenRouter ignoring: ${list.join(', ')}`);
+                break;
+            }
+            if (sub === 'fallbacks') {
+                const val = args[1]?.toLowerCase();
+                if (val !== 'on' && val !== 'off') {
+                    ctx.app.notify('Usage: /openrouter fallbacks on|off');
+                    break;
+                }
+                writeOpenRouterPreferences({ ...current, allow_fallbacks: val === 'on' });
+                ctx.app.notify(`Fallbacks ${val}`);
+                break;
+            }
+            if (sub === 'privacy') {
+                const val = args[1]?.toLowerCase();
+                if (val !== 'strict' && val !== 'allow') {
+                    ctx.app.notify('Usage: /openrouter privacy strict|allow');
+                    break;
+                }
+                writeOpenRouterPreferences({ ...current, data_collection: val === 'strict' ? 'deny' : 'allow' });
+                ctx.app.notify(`Privacy: ${val}`);
+                break;
+            }
+            ctx.app.notify(`Unknown subcommand: ${sub}`);
+            break;
+        }
+        case 'hooks': {
+            const { listInstalledHooks, formatHookList } = await import('../utils/hooks.js');
+            ctx.app.addMessage({ role: 'system', content: formatHookList(listInstalledHooks(ctx.projectPath)) });
+            break;
+        }
+        case 'rewind': {
+            const id = args[0];
+            if (!id) {
+                ctx.app.notify('Usage: /rewind <id> — run /checkpoints to see ids');
+                break;
+            }
+            const { loadCheckpoint, buildRewindGitHint } = await import('../utils/checkpoints.js');
+            const cp = loadCheckpoint(ctx.projectPath, id);
+            if (!cp) {
+                ctx.app.notify(`Checkpoint not found: ${id}`);
+                break;
+            }
+            const replacedCount = ctx.app.getMessages().length;
+            ctx.app.setMessages(cp.messages);
+            saveSession(ctx.sessionId, cp.messages, ctx.projectPath);
+            // Switch provider/model back to checkpoint state if different.
+            if (cp.provider && cp.provider !== getCurrentProvider().id)
+                setProvider(cp.provider);
+            if (cp.model && cp.model !== config.get('model'))
+                config.set('model', cp.model);
+            ctx.app.addMessage({
+                role: 'system',
+                content: `# Rewound to ${cp.name ? `**${cp.name}**` : `\`${cp.id}\``}\n\nRestored ${cp.messages.length} message${cp.messages.length === 1 ? '' : 's'} (was ${replacedCount}). Provider: \`${cp.provider}\` · Model: \`${cp.model}\`\n\n${buildRewindGitHint(cp)}`,
+            });
+            break;
+        }
         case 'context-save': {
             const messages = ctx.app.getMessages();
             if (saveSession(`context-${ctx.sessionId}`, messages, ctx.projectPath)) {
@@ -911,6 +1097,148 @@ Format: use headers per category, only include categories where you found issues
             break;
         }
         case 'skills': {
+            const sub = args[0]?.toLowerCase();
+            // Structured skill bundles (separate from the JSON skills in skills.ts).
+            if (sub === 'bundles' || sub === 'list-bundles') {
+                const { loadSkillBundles, formatBundleList } = await import('../utils/skillBundles.js');
+                ctx.app.addMessage({ role: 'system', content: formatBundleList(loadSkillBundles(ctx.projectPath)) });
+                break;
+            }
+            if (sub === 'create-bundle') {
+                const name = (args[1] ?? '').toLowerCase();
+                if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) {
+                    ctx.app.notify('Usage: /skills create-bundle <name> — lowercase letters/digits/hyphens');
+                    break;
+                }
+                const { mkdirSync, writeFileSync, existsSync } = await import('fs');
+                const { join } = await import('path');
+                const dir = join(ctx.projectPath, '.codeep', 'skills', name);
+                if (existsSync(dir)) {
+                    ctx.app.notify(`Skill ${name} already exists`);
+                    break;
+                }
+                mkdirSync(dir, { recursive: true });
+                writeFileSync(join(dir, 'SKILL.md'), `---
+name: ${name}
+description: One-sentence summary shown in the agent's catalog.
+triggers:
+  - keyword
+  - phrase
+---
+
+# ${name}
+
+Describe what this skill does. The agent reads this body verbatim when it invokes the skill.
+
+## Steps
+
+1. First step
+2. Second step
+3. …
+`);
+                ctx.app.addMessage({
+                    role: 'system',
+                    content: `Created skill bundle at \`.codeep/skills/${name}/SKILL.md\`. Edit it, then \`/skills bundles\` to confirm.`,
+                });
+                break;
+            }
+            if (sub === 'show' || sub === 'detail') {
+                const name = args[1];
+                if (!name) {
+                    ctx.app.notify('Usage: /skills show <name>');
+                    break;
+                }
+                const { findSkillBundle } = await import('../utils/skillBundles.js');
+                const bundle = findSkillBundle(name, ctx.projectPath);
+                if (!bundle) {
+                    ctx.app.notify(`Skill ${name} not found`);
+                    break;
+                }
+                ctx.app.addMessage({
+                    role: 'system',
+                    content: `# ${bundle.name}\n_${bundle.description}_\n\n**Source:** ${bundle.source}\n\n---\n\n${bundle.body}`,
+                });
+                break;
+            }
+            // Marketplace operations against codeep.dev.
+            if (sub === 'publish') {
+                const slug = args[1];
+                if (!slug) {
+                    ctx.app.notify('Usage: /skills publish <slug> [--public]');
+                    break;
+                }
+                const isPublic = args.includes('--public');
+                ctx.app.notify(`Publishing ${slug} to codeep.dev…`);
+                const { publishBundle } = await import('../utils/skillBundlesCloud.js');
+                const result = await publishBundle(ctx.projectPath, slug, { isPublic });
+                if (!result.ok) {
+                    ctx.app.notify(`Publish failed: ${result.error}`);
+                    break;
+                }
+                ctx.app.addMessage({
+                    role: 'system',
+                    content: `Published \`${slug}\` (${isPublic ? 'public' : 'private'}) to codeep.dev. Install elsewhere with \`/skills install ${result.skill?.owner_username ?? '<you>'}/${slug}\`.`,
+                });
+                break;
+            }
+            if (sub === 'install') {
+                const target = args[1];
+                if (!target) {
+                    ctx.app.notify('Usage: /skills install <owner>/<slug>');
+                    break;
+                }
+                const { installBundle } = await import('../utils/skillBundlesCloud.js');
+                ctx.app.notify(`Fetching ${target}…`);
+                const result = await installBundle(ctx.projectPath, target);
+                if (!result.ok) {
+                    ctx.app.notify(`Install failed: ${result.error}`);
+                    break;
+                }
+                ctx.app.notify(`Installed ${result.name} to .codeep/skills/${result.name}/`);
+                break;
+            }
+            if (sub === 'browse') {
+                const query = args.slice(1).join(' ').trim();
+                const { browseSkills } = await import('../utils/skillBundlesCloud.js');
+                ctx.app.notify('Fetching marketplace…');
+                const result = await browseSkills({ query });
+                if (!result.ok) {
+                    ctx.app.notify(`Browse failed: ${result.error}`);
+                    break;
+                }
+                const skills = result.skills ?? [];
+                if (skills.length === 0) {
+                    ctx.app.addMessage({ role: 'system', content: query ? `_No public skills matching "${query}"._` : '_No public skills published yet._' });
+                    break;
+                }
+                const lines = [`# ${query ? `Skills matching "${query}"` : 'Public skills'}`, ''];
+                for (const s of skills.slice(0, 30)) {
+                    const owner = s.owner_username ?? s.github_id;
+                    const ver = s.version ? ` v${s.version}` : '';
+                    lines.push(`- **${s.name}** \`${owner}/${s.slug}\`${ver} — ${s.description} _(${s.install_count} installs)_`);
+                }
+                if (skills.length > 30)
+                    lines.push('', `_(showing first 30 of ${skills.length})_`);
+                lines.push('', 'Install with `/skills install <owner>/<slug>`.');
+                ctx.app.addMessage({ role: 'system', content: lines.join('\n') });
+                break;
+            }
+            if (sub === 'unpublish') {
+                const target = args[1];
+                if (!target) {
+                    ctx.app.notify('Usage: /skills unpublish <owner>/<slug>');
+                    break;
+                }
+                const { unpublishBundle } = await import('../utils/skillBundlesCloud.js');
+                const result = await unpublishBundle(target);
+                if (!result.ok) {
+                    ctx.app.notify(`Unpublish failed: ${result.error}`);
+                    break;
+                }
+                ctx.app.notify(`Unpublished ${target} from codeep.dev`);
+                break;
+            }
+            // Default: built-in JSON skills (legacy behaviour).
             import('../utils/skills.js').then(({ getAllSkills, searchSkills, formatSkillsList, getSkillStats }) => {
                 const query = args.join(' ').toLowerCase();
                 if (query === 'stats') {
@@ -1352,10 +1680,318 @@ Format: use headers per category, only include categories where you found issues
             ctx.app.notify(`Memory saved (${intelligence.notes.length} total): "${note}"`);
             break;
         }
-        default:
+        case 'commands': {
+            const { loadCustomCommands, formatCommandList } = await import('../utils/customCommands.js');
+            ctx.app.addMessage({ role: 'system', content: formatCommandList(loadCustomCommands(ctx.projectPath)) });
+            break;
+        }
+        case 'mcp': {
+            // Mirrors the ACP `/mcp` handler in src/acp/commands.ts. In TUI the
+            // session id is the constant `codeep-tui` (the same one main.ts uses
+            // when it spawns project MCP servers in the background) and the
+            // workspace root is ctx.projectPath. Without a project we can still
+            // browse the marketplace, but anything that mutates project config
+            // refuses with a clear message.
+            const sub = args[0]?.toLowerCase();
+            const TUI_SESSION = 'codeep-tui';
+            const projectPath = ctx.projectPath;
+            const requireProject = () => {
+                if (!projectPath) {
+                    ctx.app.notify('Open a project (cd into it before running codeep) to add or modify MCP servers.');
+                    return false;
+                }
+                return true;
+            };
+            const { addProjectMcpServer, removeProjectMcpServer, loadMcpServerConfig } = await import('../utils/mcpConfig.js');
+            const { registerSessionServers } = await import('../utils/mcpRegistry.js');
+            if (sub === 'add') {
+                if (!requireProject())
+                    break;
+                const name = args[1];
+                const command = args[2];
+                if (!name || !command) {
+                    ctx.app.addMessage({ role: 'system', content: 'Usage: `/mcp add <name> <command> [args...]` — e.g. `/mcp add fs npx @modelcontextprotocol/server-filesystem /path`' });
+                    break;
+                }
+                const extraArgs = args.slice(3);
+                addProjectMcpServer(projectPath, { name, command, args: extraArgs });
+                ctx.app.notify(`Saved MCP server ${name} to .codeep/mcp_servers.json. Spawning…`);
+                const merged = loadMcpServerConfig(projectPath);
+                const { registered, errors } = await registerSessionServers(TUI_SESSION, merged, { workspaceRoot: projectPath });
+                const ok = registered.filter(t => t.serverName === name);
+                const failed = errors.find(e => e.server === name);
+                ctx.app.addMessage({
+                    role: 'system',
+                    content: failed
+                        ? `Saved \`${name}\` but spawn failed: \`${failed.error}\``
+                        : `Added \`${name}\` (${ok.length} tool${ok.length === 1 ? '' : 's'} available).`,
+                });
+                break;
+            }
+            if (sub === 'remove') {
+                if (!requireProject())
+                    break;
+                const name = args[1];
+                if (!name) {
+                    ctx.app.addMessage({ role: 'system', content: 'Usage: `/mcp remove <name>`' });
+                    break;
+                }
+                const removed = removeProjectMcpServer(projectPath, name);
+                if (!removed) {
+                    ctx.app.addMessage({ role: 'system', content: `No project-scoped MCP server named \`${name}\`.` });
+                    break;
+                }
+                const merged = loadMcpServerConfig(projectPath);
+                await registerSessionServers(TUI_SESSION, merged, { workspaceRoot: projectPath });
+                ctx.app.addMessage({ role: 'system', content: `Removed \`${name}\` from project config and stopped its process.` });
+                break;
+            }
+            if (sub === 'browse') {
+                const { formatMarketplaceList, findMarketplaceEntry, formatMarketplaceEntry, MCP_MARKETPLACE } = await import('../utils/mcpMarketplace.js');
+                const detail = args[1];
+                if (detail) {
+                    const entry = findMarketplaceEntry(detail);
+                    if (!entry) {
+                        ctx.app.addMessage({ role: 'system', content: `Marketplace id not found: \`${detail}\`. Run \`/mcp browse\` for the list.` });
+                    }
+                    else {
+                        const argHints = entry.argHints?.map(h => `<${h.placeholder ?? 'arg'}>`).join(' ') ?? '';
+                        ctx.app.addMessage({ role: 'system', content: formatMarketplaceEntry(entry) + `\n\nInstall with \`/mcp install ${entry.id} ${argHints}\`` });
+                    }
+                    break;
+                }
+                ctx.app.addMessage({ role: 'system', content: formatMarketplaceList() + `\n\nRun \`/mcp browse <id>\` for details or \`/mcp install <id> [args]\` to install. Total: ${MCP_MARKETPLACE.length}.` });
+                break;
+            }
+            if (sub === 'install') {
+                if (!requireProject())
+                    break;
+                const id = args[1];
+                if (!id) {
+                    ctx.app.addMessage({ role: 'system', content: 'Usage: `/mcp install <id> [extra args...]` — run `/mcp browse` to see ids.' });
+                    break;
+                }
+                const { findMarketplaceEntry } = await import('../utils/mcpMarketplace.js');
+                const entry = findMarketplaceEntry(id);
+                if (!entry) {
+                    ctx.app.addMessage({ role: 'system', content: `Marketplace id not found: \`${id}\`. Run \`/mcp browse\` for the list.` });
+                    break;
+                }
+                const extraArgs = args.slice(2);
+                const fullArgs = [...(entry.server.args ?? []), ...extraArgs];
+                addProjectMcpServer(projectPath, {
+                    name: entry.id,
+                    command: entry.server.command,
+                    args: fullArgs,
+                    env: entry.server.env,
+                    url: entry.server.url,
+                    headers: entry.server.headers,
+                });
+                ctx.app.notify(`Saved ${entry.id} to project config. Spawning…`);
+                const merged = loadMcpServerConfig(projectPath);
+                const { registered, errors } = await registerSessionServers(TUI_SESSION, merged, { workspaceRoot: projectPath });
+                const failed = errors.find(e => e.server === entry.id);
+                const lines = [];
+                if (failed) {
+                    lines.push(`Saved \`${entry.id}\` but spawn failed: \`${failed.error}\``);
+                }
+                else {
+                    const ok = registered.filter(t => t.serverName === entry.id);
+                    lines.push(`Installed **${entry.name}** (\`${entry.id}\`) — ${ok.length} tool${ok.length === 1 ? '' : 's'} available.`);
+                }
+                if (entry.envNotes?.length) {
+                    lines.push('', '**Environment variables you may need:**');
+                    for (const e of entry.envNotes) {
+                        const req = e.required ? ' (required)' : '';
+                        lines.push(`- \`${e.name}\`${req} — ${e.description}`);
+                    }
+                }
+                ctx.app.addMessage({ role: 'system', content: lines.join('\n') });
+                break;
+            }
+            if (sub === 'reload') {
+                if (!requireProject())
+                    break;
+                ctx.app.notify('Reloading MCP server config…');
+                const merged = loadMcpServerConfig(projectPath);
+                const { registered, errors } = await registerSessionServers(TUI_SESSION, merged, { workspaceRoot: projectPath });
+                const lines = [`## MCP reloaded`, '', `**${registered.length}** tool${registered.length === 1 ? '' : 's'} from **${merged.length}** server${merged.length === 1 ? '' : 's'}.`];
+                if (errors.length > 0) {
+                    lines.push('', '### Failed servers');
+                    for (const e of errors)
+                        lines.push(`- **${e.server}** — \`${e.error}\``);
+                }
+                ctx.app.addMessage({ role: 'system', content: lines.join('\n') });
+                break;
+            }
+            if (sub === 'resources') {
+                const { getSessionResources, awaitSessionReady } = await import('../utils/mcpRegistry.js');
+                await awaitSessionReady(TUI_SESSION);
+                const groups = await getSessionResources(TUI_SESSION);
+                if (groups.length === 0) {
+                    ctx.app.addMessage({ role: 'system', content: '_No MCP server in this session exposes resources._' });
+                    break;
+                }
+                const lines = ['## MCP resources', ''];
+                for (const g of groups) {
+                    lines.push(`**${g.serverName}** — ${g.resources.length} resource${g.resources.length === 1 ? '' : 's'}`);
+                    for (const r of g.resources) {
+                        const label = r.name ? `${r.name} — ` : '';
+                        const mime = r.mimeType ? ` (${r.mimeType})` : '';
+                        lines.push(`- ${label}\`${r.uri}\`${mime}${r.description ? ` — ${r.description}` : ''}`);
+                    }
+                    lines.push('');
+                }
+                lines.push('Read one with `/mcp read <uri>`.');
+                ctx.app.addMessage({ role: 'system', content: lines.join('\n').trim() });
+                break;
+            }
+            if (sub === 'read') {
+                const uri = args[1];
+                if (!uri) {
+                    ctx.app.addMessage({ role: 'system', content: 'Usage: `/mcp read <uri>` — run `/mcp resources` to see available URIs.' });
+                    break;
+                }
+                const { readSessionResource } = await import('../utils/mcpRegistry.js');
+                try {
+                    const contents = await readSessionResource(TUI_SESSION, uri);
+                    if (contents.length === 0) {
+                        ctx.app.addMessage({ role: 'system', content: `_No content returned for \`${uri}\`._` });
+                        break;
+                    }
+                    const lines = [`## Resource: \`${uri}\``, ''];
+                    for (const c of contents) {
+                        if (c.text !== undefined) {
+                            const fence = c.mimeType?.includes('json') ? 'json' : c.mimeType?.includes('markdown') ? 'markdown' : '';
+                            lines.push('```' + fence);
+                            lines.push(c.text);
+                            lines.push('```');
+                        }
+                        else if (c.blob) {
+                            lines.push(`_(${c.mimeType ?? 'binary'} blob, ${c.blob.length} base64 chars — not rendered)_`);
+                        }
+                    }
+                    ctx.app.addMessage({ role: 'system', content: lines.join('\n') });
+                }
+                catch (err) {
+                    ctx.app.addMessage({ role: 'system', content: `Failed to read \`${uri}\`: ${err.message}` });
+                }
+                break;
+            }
+            if (sub === 'prompts') {
+                const { getSessionPrompts, awaitSessionReady } = await import('../utils/mcpRegistry.js');
+                await awaitSessionReady(TUI_SESSION);
+                const groups = await getSessionPrompts(TUI_SESSION);
+                if (groups.length === 0) {
+                    ctx.app.addMessage({ role: 'system', content: '_No MCP server in this session exposes prompt templates._' });
+                    break;
+                }
+                const lines = ['## MCP prompt templates', ''];
+                for (const g of groups) {
+                    lines.push(`**${g.serverName}** — ${g.prompts.length} prompt${g.prompts.length === 1 ? '' : 's'}`);
+                    for (const p of g.prompts) {
+                        const argList = p.arguments?.length
+                            ? ` (${p.arguments.map(a => a.required ? a.name : `[${a.name}]`).join(', ')})`
+                            : '';
+                        lines.push(`- \`${p.name}\`${argList}${p.description ? ` — ${p.description}` : ''}`);
+                    }
+                    lines.push('');
+                }
+                lines.push('Materialise one with `/mcp prompt <server> <name> [key=value...]`.');
+                ctx.app.addMessage({ role: 'system', content: lines.join('\n').trim() });
+                break;
+            }
+            if (sub === 'prompt') {
+                const serverName = args[1];
+                const name = args[2];
+                if (!serverName || !name) {
+                    ctx.app.addMessage({ role: 'system', content: 'Usage: `/mcp prompt <server> <name> [key=value ...]`' });
+                    break;
+                }
+                const promptArgs = {};
+                for (const tok of args.slice(3)) {
+                    const eq = tok.indexOf('=');
+                    if (eq > 0)
+                        promptArgs[tok.slice(0, eq)] = tok.slice(eq + 1);
+                }
+                const { getSessionPrompt } = await import('../utils/mcpRegistry.js');
+                try {
+                    const { description, messages } = await getSessionPrompt(TUI_SESSION, serverName, name, promptArgs);
+                    const lines = [`## Prompt \`${serverName}/${name}\``];
+                    if (description)
+                        lines.push(`_${description}_`);
+                    lines.push('');
+                    for (const m of messages) {
+                        const text = typeof m.content?.text === 'string' ? m.content.text : JSON.stringify(m.content);
+                        lines.push(`**${m.role}:** ${text}`);
+                        lines.push('');
+                    }
+                    ctx.app.addMessage({ role: 'system', content: lines.join('\n').trim() });
+                }
+                catch (err) {
+                    ctx.app.addMessage({ role: 'system', content: `Failed to materialise prompt: ${err.message}` });
+                }
+                break;
+            }
+            // Default: list servers + tools for the current session.
+            const { getSessionTools, getSessionRegistrationErrors, awaitSessionReady } = await import('../utils/mcpRegistry.js');
+            await awaitSessionReady(TUI_SESSION);
+            const tools = await getSessionTools(TUI_SESSION);
+            const mcpErrors = getSessionRegistrationErrors(TUI_SESSION);
+            if (tools.length === 0 && mcpErrors.length === 0) {
+                ctx.app.addMessage({
+                    role: 'system',
+                    content: [
+                        '_No MCP servers connected to this session._',
+                        '',
+                        'Add one with `/mcp add <name> <command> [args...]` — it persists to `.codeep/mcp_servers.json`.',
+                        'Or browse the marketplace with `/mcp browse` and install with `/mcp install <id>`.',
+                    ].join('\n'),
+                });
+                break;
+            }
+            const lines = ['## MCP servers', ''];
+            if (tools.length > 0) {
+                const byServer = new Map();
+                for (const t of tools) {
+                    if (!byServer.has(t.serverName))
+                        byServer.set(t.serverName, []);
+                    byServer.get(t.serverName).push(t);
+                }
+                for (const [serverName, serverTools] of byServer) {
+                    lines.push(`**${serverName}** — ${serverTools.length} tool${serverTools.length === 1 ? '' : 's'}`);
+                    for (const t of serverTools) {
+                        const desc = t.description ? ` — ${t.description}` : '';
+                        lines.push(`- \`${t.agentName}\`${desc}`);
+                    }
+                    lines.push('');
+                }
+            }
+            if (mcpErrors.length > 0) {
+                lines.push('### Failed servers');
+                for (const e of mcpErrors)
+                    lines.push(`- **${e.server}** — \`${e.error}\``);
+            }
+            ctx.app.addMessage({ role: 'system', content: lines.join('\n').trim() });
+            break;
+        }
+        default: {
+            // 1. Try custom user command (project + global Markdown templates).
+            const { findCustomCommand, expandCommand } = await import('../utils/customCommands.js');
+            const custom = findCustomCommand(command, ctx.projectPath);
+            if (custom) {
+                const expandedPrompt = expandCommand(custom, args);
+                ctx.app.notify(`Running custom command /${command} (${custom.scope})`);
+                ctx.app.addMessage({ role: 'user', content: expandedPrompt });
+                const { runAgentTask } = await import('./agentExecution.js');
+                runAgentTask(expandedPrompt, false, ctx, () => null, () => { });
+                break;
+            }
+            // 2. Fall through to skill registry.
             runSkill(command, args, ctx).then(handled => {
                 if (!handled)
                     ctx.app.notify(`Unknown command: /${command}`);
             });
+        }
     }
 }