@gethmy/mcp 2.2.1 → 2.2.3

package/dist/lib/server.js

@@ -4,13 +4,14 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { detectContradictions, extractLearnings, extractMidSessionLearnings, } from "./active-learning.js";
-import { getClient, requestWithBearer, resetClient, signupUser, } from "./api-client.js";
+import { getClient, resetClient, signupUser, } from "./api-client.js";
 import { AUTO_START_TRIGGERS, destroyAutoSession, initAutoSession, markExplicit, shutdownAllSessions, trackActivity, untrack, } from "./auto-session.js";
 import { getActiveProjectId, getActiveWorkspaceId, getApiUrl, getMemoryDir, getUserEmail, isConfigured, saveConfig, setActiveProject, setActiveWorkspace, } from "./config.js";
 import { consolidateMemories } from "./consolidation.js";
 import { assembleContext, cacheManifest, computeRelevanceScore, getCachedManifest, mapToContextEntity, recordContextFeedback, trackSessionAssembly, } from "./context-assembly.js";
 import { autoExpandGraph } from "./graph-expansion.js";
 import { runLifecycleMaintenance } from "./lifecycle-maintenance.js";
+import { onboardNewUser } from "./onboard.js";
 const memorySessions = new Map();
 function initMemorySession(cardId, agentIdentifier, agentName) {
     memorySessions.set(cardId, {
@@ -168,18 +169,22 @@ const TOOLS = {
         },
     },
     harmony_move_card: {
-        description: "Move a card to a different column or position",
+        description: "Move a card to a different column or position. Provide either columnId (UUID) or columnName (e.g. 'Review', 'Done').",
         inputSchema: {
             type: "object",
             properties: {
                 cardId: { type: "string", description: "Card ID to move" },
-                columnId: { type: "string", description: "Target column ID" },
+                columnId: { type: "string", description: "Target column ID (UUID)" },
+                columnName: {
+                    type: "string",
+                    description: "Target column name (e.g. 'To Do', 'In Progress', 'Review', 'Done'). Used if columnId is not provided.",
+                },
                 position: {
                     type: "number",
                     description: "Position in column (0-indexed)",
                 },
             },
-            required: ["cardId", "columnId"],
+            required: ["cardId"],
         },
     },
     harmony_archive_card: {
@@ -312,14 +317,21 @@ const TOOLS = {
         },
     },
     harmony_add_label_to_card: {
-        description: "Add a label to a card",
+        description: "Add a label to a card. Provide labelId directly, or labelName to look up (or auto-create) the label by name.",
         inputSchema: {
             type: "object",
             properties: {
                 cardId: { type: "string" },
-                labelId: { type: "string" },
+                labelId: {
+                    type: "string",
+                    description: "Label ID (optional if labelName provided)",
+                },
+                labelName: {
+                    type: "string",
+                    description: "Label name — will look up or create if not found",
+                },
             },
-            required: ["cardId", "labelId"],
+            required: ["cardId"],
         },
     },
     harmony_remove_label_from_card: {
@@ -1703,6 +1715,19 @@ export function registerHandlers(server, deps) {
         throw new Error(`Unknown resource: ${uri}`);
     });
 }
+/** Resolve a column name to its ID. Prefers exact match, falls back to substring. */
+async function resolveColumnByName(client, projectId, columnName) {
+    const board = await client.getBoard(projectId, { summary: true });
+    const columns = board.columns;
+    const lower = columnName.toLowerCase();
+    const col = columns.find((c) => c.name.toLowerCase() === lower) ||
+        columns.find((c) => c.name.toLowerCase().includes(lower));
+    if (!col) {
+        const available = columns.map((c) => c.name).join(", ");
+        throw new Error(`Column "${columnName}" not found. Available columns: ${available}`);
+    }
+    return col;
+}
 async function handleToolCall(name, args, deps) {
     // Unauthenticated tools that don't require an API key
     const unauthenticatedTools = ["harmony_signup", "harmony_onboard"];
@@ -1757,19 +1782,36 @@ async function handleToolCall(name, args, deps) {
         }
         case "harmony_move_card": {
             const cardId = z.string().uuid().parse(args.cardId);
-            const columnId = z.string().uuid().parse(args.columnId);
             const position = args.position !== undefined
                 ? z.number().int().min(0).parse(args.position)
                 : undefined;
+            // Resolve columnId — accept UUID directly or resolve from columnName
+            let columnId;
+            let resolvedProjectId;
+            if (args.columnId) {
+                columnId = z.string().uuid().parse(args.columnId);
+            }
+            else if (args.columnName) {
+                const columnName = z.string().parse(args.columnName);
+                const { card: cardForProject } = await client.getCard(cardId);
+                resolvedProjectId = cardForProject
+                    ?.project_id;
+                if (!resolvedProjectId)
+                    throw new Error("Card has no project");
+                const col = await resolveColumnByName(client, resolvedProjectId, columnName);
+                columnId = col.id;
+            }
+            else {
+                throw new Error("Either columnId or columnName is required");
+            }
             const result = await client.moveCard(cardId, columnId, position);
             // Auto-end active agent session when moving to Review or Done
             let sessionEnded = false;
             try {
                 const { card } = result;
-                if (card?.project_id) {
-                    const board = await client.getBoard(card.project_id, {
-                        summary: true,
-                    });
+                const projectId = card?.project_id || resolvedProjectId;
+                if (projectId) {
+                    const board = await client.getBoard(projectId, { summary: true });
                     const columns = board.columns;
                     const destCol = columns.find((c) => c.id === columnId);
                     const colName = destCol?.name?.toLowerCase() || "";
@@ -1870,7 +1912,38 @@ async function handleToolCall(name, args, deps) {
         }
         case "harmony_add_label_to_card": {
             const cardId = z.string().uuid().parse(args.cardId);
-            const labelId = z.string().uuid().parse(args.labelId);
+            let labelId = args.labelId
+                ? z.string().uuid().parse(args.labelId)
+                : undefined;
+            const labelName = args.labelName
+                ? z.string().min(1).max(100).parse(args.labelName)
+                : undefined;
+            // If labelName provided without labelId, look up or create the label
+            if (!labelId && labelName) {
+                const { card } = await client.getCard(cardId);
+                const projectId = card.project_id;
+                if (!projectId) {
+                    throw new Error("Cannot resolve label by name: card has no project_id");
+                }
+                if (projectId) {
+                    const board = await client.getBoard(projectId, { summary: true });
+                    const labels = board.labels;
+                    const existing = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                    if (existing) {
+                        labelId = existing.id;
+                    }
+                    else {
+                        const created = await client.createLabel(projectId, {
+                            name: labelName,
+                            color: "#57b8a5",
+                        });
+                        labelId = created.label.id;
+                    }
+                }
+            }
+            if (!labelId) {
+                throw new Error("Either labelId or labelName must be provided");
+            }
             await client.addLabelToCard(cardId, labelId);
             return { success: true };
         }
@@ -2015,10 +2088,18 @@ async function handleToolCall(name, args, deps) {
                         }
                         if (addLabels?.length) {
                             for (const labelName of addLabels) {
-                                const label = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                                let label = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                                if (!label && projectId) {
+                                    const created = await client.createLabel(projectId, {
+                                        name: labelName,
+                                        color: "#57b8a5",
+                                    });
+                                    label = created
+                                        .label;
+                                }
                                 if (label) {
                                     await client.addLabelToCard(cardId, label.id);
-                                    labelsAdded.push(label.name);
+                                    labelsAdded.push(label.name ?? labelName);
                                 }
                             }
                         }
@@ -2176,29 +2257,25 @@ async function handleToolCall(name, args, deps) {
             // Final flush of any pending memory actions before ending the session
             await flushMemoryActions(client, cardId);
             cleanupMemorySession(cardId);
-            const result = await client.endAgentSession(cardId, {
-                status: sessionStatus,
-                progressPercent: endProgressPercent,
-            });
-            // Remove from auto-session tracking
+            // End the session — tolerate failure (e.g., session already ended or not found)
+            let result = { session: null };
+            let sessionEndError = null;
+            try {
+                result = await client.endAgentSession(cardId, {
+                    status: sessionStatus,
+                    progressPercent: endProgressPercent,
+                });
+            }
+            catch (err) {
+                sessionEndError =
+                    err instanceof Error ? err.message : "Failed to end session";
+            }
+            // Remove from auto-session tracking regardless
             untrack(cardId);
             let movedTo = null;
-            const _learningsExtracted = 0;
-            // Get card info for move and learning extraction
-            let _cardTitle = "";
-            let _cardLabels = [];
-            let _cardDescription = "";
-            let _cardSubtasks = [];
             try {
                 const { card } = await client.getCard(cardId);
                 const typedCard = card;
-                _cardTitle = typedCard.title || "";
-                _cardLabels = (typedCard.labels || []).map((l) => l.name);
-                _cardDescription = typedCard.description || "";
-                _cardSubtasks = (typedCard.subtasks || []).map((s) => ({
-                    title: s.title,
-                    done: s.done,
-                }));
                 const projectId = typedCard.project_id;
                 // Remove "agent" label when session is completed (not paused)
                 if (sessionStatus === "completed" && typedCard.labels?.length) {
@@ -2208,15 +2285,9 @@ async function handleToolCall(name, args, deps) {
                     }
                 }
                 if (moveToColumn && projectId) {
-                    const board = await client.getBoard(projectId, {
-                        summary: true,
-                    });
-                    const columns = board.columns;
-                    const col = columns.find((c) => c.name.toLowerCase().includes(moveToColumn.toLowerCase()));
-                    if (col) {
-                        await client.moveCard(cardId, col.id);
-                        movedTo = col.name;
-                    }
+                    const col = await resolveColumnByName(client, projectId, moveToColumn);
+                    await client.moveCard(cardId, col.id);
+                    movedTo = col.name;
                 }
             }
             catch {
@@ -2227,6 +2298,7 @@ async function handleToolCall(name, args, deps) {
             const pipelineResult = await runEndSessionPipeline(client, deps, cardId, sessionStatus, endProgressPercent, sessionObj);
             return {
                 success: true,
+                ...(sessionEndError && { sessionEndError }),
                 movedTo,
                 learningsExtracted: pipelineResult.learningsExtracted,
                 feedbackAdjusted: pipelineResult.feedbackAdjusted,
@@ -3072,44 +3144,28 @@ async function handleToolCall(name, args, deps) {
             const projectName = args.projectName || "My First Project";
             const template = args.template || "kanban";
             const keyName = args.keyName || "mcp-agent";
-            const apiUrl = deps.getApiUrl();
-            // 1. Signup
-            const signupResult = await signupUser(apiUrl, {
+            const result = await onboardNewUser({
                 email,
                 password,
-                full_name: fullName,
-            });
-            const token = signupResult.session.access_token;
-            // 2. Create workspace
-            const workspaceResult = await requestWithBearer(apiUrl, token, "POST", "/workspaces", {
-                name: workspaceName,
-            });
-            // 3. Create project
-            const projectResult = await requestWithBearer(apiUrl, token, "POST", "/projects", {
-                workspaceId: workspaceResult.workspace.id,
-                name: projectName,
+                fullName,
+                workspaceName,
+                projectName,
                 template,
+                keyName,
+                apiUrl: deps.getApiUrl(),
             });
-            // 4. Generate API key
-            const keyResult = await requestWithBearer(apiUrl, token, "POST", "/api-keys", {
-                name: keyName,
-            });
-            // 5. Save config
-            deps.saveConfig({ apiKey: keyResult.rawKey });
-            deps.setActiveWorkspace(workspaceResult.workspace.id);
-            deps.setActiveProject(projectResult.project.id);
-            // 6. Reset client so singleton picks up new key
+            // Save config and reset client
+            deps.saveConfig({ apiKey: result.apiKey.rawKey });
+            deps.setActiveWorkspace(result.workspace.id);
+            deps.setActiveProject(result.project.id);
             deps.resetClient();
             return {
                 success: true,
-                user: signupResult.user,
-                workspace: workspaceResult.workspace,
-                project: projectResult.project,
-                columns: projectResult.columns,
-                apiKey: {
-                    rawKey: keyResult.rawKey,
-                    prefix: keyResult.apiKey.prefix,
-                },
+                user: result.user,
+                workspace: result.workspace,
+                project: result.project,
+                columns: result.columns,
+                apiKey: result.apiKey,
                 message: `Onboarding complete! Account created for ${email}. Workspace "${workspaceName}" and project "${projectName}" are ready. API key saved to config.`,
             };
         }

package/dist/lib/skills.js

@@ -4,7 +4,7 @@ import { areSkillsInstalled } from "./config.js";
 export const SKILLS_VERSION = "3";
 const VERSION_MARKER_PREFIX = "<!-- skills-version:";
 /**
- * Legacy workflow prompt used by Codex, Cursor, Windsurf agents.
+ * Legacy workflow prompt used by Codex, Cursor agents.
  * Claude Code skills use the newer SKILL_DEFINITIONS content instead.
  */
 export const HARMONY_WORKFLOW_PROMPT = `# Harmony Card Workflow

package/dist/lib/tui/setup.js

@@ -2,7 +2,8 @@ import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, } from "node
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import * as p from "@clack/prompts";
-import { areSkillsInstalled, getConfigPath, getLocalConfigPath, hasProjectContext, isConfigured, loadConfig, saveLocalConfig, } from "../config.js";
+import { areSkillsInstalled, getConfigPath, getLocalConfigPath, hasProjectContext, isConfigured, loadConfig, saveConfig, saveLocalConfig, setActiveProject, setActiveWorkspace, } from "../config.js";
+import { onboardNewUser } from "../onboard.js";
 import { buildSkillFile, HARMONY_WORKFLOW_PROMPT } from "../skills.js";
 import { detectAgents } from "./agents.js";
 import { runDocsStep } from "./docs.js";
@@ -388,47 +389,172 @@ export async function runSetup(options = {}) {
     if (options.workspaceId || options.projectId) {
         needsContext = true;
     }
-    // Step 1: API Key
+    // Step 1: API Key (or create account)
     let apiKey = options.apiKey || existingConfig.apiKey;
     let userEmail = options.userEmail || existingConfig.userEmail || undefined;
+    let selectedWorkspaceIdFromSignup;
+    let selectedProjectIdFromSignup;
+    let selectedWorkspaceNameFromSignup;
+    let selectedProjectNameFromSignup;
+    let createdNewAccount = false;
     if (needsApiKey || !apiKey || !apiKey.startsWith("hmy_")) {
-        const keyInput = await p.text({
-            message: "Enter your Harmony API key",
-            placeholder: "hmy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
-            validate: (value) => {
-                if (!value)
-                    return "API key is required";
-                if (!value.startsWith("hmy_"))
-                    return 'API key must start with "hmy_"';
-                if (value.length < 20)
-                    return "API key is too short";
-                return undefined;
-            },
-        });
-        if (p.isCancel(keyInput)) {
-            p.cancel("Setup cancelled");
-            process.exit(0);
+        // Determine path: create account or enter API key
+        let useNewAccount = options.newAccount === true;
+        if (!useNewAccount && options.apiKey) {
+            // API key passed via flag — skip the choice prompt
+            useNewAccount = false;
+        }
+        else if (!useNewAccount && !options.apiKey) {
+            const getStarted = await p.select({
+                message: "How would you like to get started?",
+                options: [
+                    {
+                        value: "create",
+                        label: "Create a free account",
+                        hint: "recommended for new users",
+                    },
+                    {
+                        value: "apikey",
+                        label: "I already have an API key",
+                    },
+                ],
+            });
+            if (p.isCancel(getStarted)) {
+                p.cancel("Setup cancelled");
+                process.exit(0);
+            }
+            useNewAccount = getStarted === "create";
+        }
+        if (useNewAccount) {
+            // --- Create account flow ---
+            const fullName = options.name ||
+                (await p.text({
+                    message: "Full name",
+                    placeholder: "Jane Smith",
+                    validate: (v) => {
+                        if (!v || v.trim().length === 0)
+                            return "Name is required";
+                        if (v.length > 100)
+                            return "Name must be 100 characters or less";
+                        return undefined;
+                    },
+                }));
+            if (p.isCancel(fullName)) {
+                p.cancel("Setup cancelled");
+                process.exit(0);
+            }
+            const email = options.userEmail ||
+                (await p.text({
+                    message: "Email",
+                    placeholder: "you@example.com",
+                    validate: (v) => {
+                        if (!v)
+                            return "Email is required";
+                        if (v.length > 254)
+                            return "Email is too long";
+                        if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v))
+                            return "Invalid email format";
+                        return undefined;
+                    },
+                }));
+            if (p.isCancel(email)) {
+                p.cancel("Setup cancelled");
+                process.exit(0);
+            }
+            const password = (await p.password({
+                message: "Password",
+                validate: (v) => {
+                    if (!v)
+                        return "Password is required";
+                    if (v.length < 8)
+                        return "Password must be at least 8 characters";
+                    if (v.length > 128)
+                        return "Password must be 128 characters or less";
+                    return undefined;
+                },
+            }));
+            if (p.isCancel(password)) {
+                p.cancel("Setup cancelled");
+                process.exit(0);
+            }
+            const spinner = p.spinner();
+            spinner.start("Creating your account...");
+            try {
+                const result = await onboardNewUser({
+                    email: email,
+                    password: password,
+                    fullName: fullName,
+                });
+                spinner.stop(colors.success(`Account created for ${result.user.email}`));
+                apiKey = result.apiKey.rawKey;
+                userEmail = result.user.email;
+                selectedWorkspaceIdFromSignup = result.workspace.id;
+                selectedProjectIdFromSignup = result.project.id;
+                selectedWorkspaceNameFromSignup = result.workspace.name;
+                selectedProjectNameFromSignup = result.project.name;
+                createdNewAccount = true;
+                needsApiKey = true;
+                // Save config immediately
+                saveConfig({ apiKey, userEmail, apiUrl: API_URL });
+                setActiveWorkspace(selectedWorkspaceIdFromSignup);
+                setActiveProject(selectedProjectIdFromSignup);
+                p.log.success("Workspace and board created");
+            }
+            catch (error) {
+                spinner.stop(colors.error("Account creation failed"));
+                const msg = error instanceof Error ? error.message : "Unknown error";
+                if (msg.includes("already") || msg.includes("409")) {
+                    p.log.error("Account already exists. Sign in at app.gethmy.com to get your API key, or re-run setup and choose 'I already have an API key'.");
+                }
+                else {
+                    p.log.error(msg);
+                    p.log.info("Please try again or visit https://app.gethmy.com");
+                }
+                process.exit(1);
+            }
+        }
+        else {
+            // --- Existing API key flow ---
+            const keyInput = await p.text({
+                message: "Enter your Harmony API key",
+                placeholder: "hmy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+                validate: (value) => {
+                    if (!value)
+                        return "API key is required";
+                    if (!value.startsWith("hmy_"))
+                        return 'API key must start with "hmy_"';
+                    if (value.length < 20)
+                        return "API key is too short";
+                    return undefined;
+                },
+            });
+            if (p.isCancel(keyInput)) {
+                p.cancel("Setup cancelled");
+                process.exit(0);
+            }
+            apiKey = keyInput;
+            needsApiKey = true;
         }
-        apiKey = keyInput;
-        needsApiKey = true;
     }
     else {
         p.log.success(`Using existing API key: ${apiKey.slice(0, 8)}...`);
     }
-    // Validate API key
+    // Validate API key (skip if we just created account — key is guaranteed valid)
     const spinner = p.spinner();
-    spinner.start("Validating API key...");
-    const validation = await validateApiKey(apiKey);
-    if (!validation.valid) {
-        spinner.stop(colors.error("API key validation failed"));
-        p.log.error(validation.error || "Could not connect to Harmony API");
-        p.log.info("Get an API key at: https://app.gethmy.com/user/keys");
-        process.exit(1);
-    }
-    if (!userEmail) {
-        userEmail = validation.email;
-    }
-    spinner.stop(colors.success(userEmail ? `Connected as ${userEmail}` : "API key validated"));
+    if (!createdNewAccount) {
+        spinner.start("Validating API key...");
+        const validation = await validateApiKey(apiKey);
+        if (!validation.valid) {
+            spinner.stop(colors.error("API key validation failed"));
+            p.log.error(validation.error || "Could not connect to Harmony API");
+            p.log.info("Get an API key at: https://app.gethmy.com/user/keys");
+            process.exit(1);
+        }
+        if (!userEmail) {
+            userEmail = validation.email;
+        }
+        spinner.stop(colors.success(userEmail ? `Connected as ${userEmail}` : "API key validated"));
+    }
     // Step 2: Check if skills are already installed
     let selectedAgents = [];
     let installMode = options.installMode || "global";
@@ -502,10 +628,14 @@ export async function runSetup(options = {}) {
         }
     }
     // Step 3: Workspace and Project Selection
-    let selectedWorkspaceId = options.workspaceId;
-    let selectedProjectId = options.projectId;
-    let selectedWorkspaceName;
-    let selectedProjectName;
+    let selectedWorkspaceId = selectedWorkspaceIdFromSignup || options.workspaceId;
+    let selectedProjectId = selectedProjectIdFromSignup || options.projectId;
+    let selectedWorkspaceName = selectedWorkspaceNameFromSignup;
+    let selectedProjectName = selectedProjectNameFromSignup;
+    // Skip context selection if we just created a new account
+    if (createdNewAccount) {
+        needsContext = false;
+    }
     if (needsContext && !options.skipContext) {
         // Fetch workspaces
         spinner.start("Fetching workspaces...");
@@ -742,29 +872,52 @@ export async function runSetup(options = {}) {
     // Step 10: Show completion message
     console.log("");
     p.outro(colors.success("Setup complete!"));
-    console.log("");
-    console.log(`  ${colors.bold("Configuration:")}`);
-    console.log(`    API key:   ${formatPath(getConfigPath(), home)}`);
-    if (needsSkills && selectedAgents.length > 0) {
-        console.log(`    Skills:    ${installMode === "global" ? "~/.agents/skills/ (global)" : ".claude/skills/ (local)"}`);
-    }
-    if (selectedWorkspaceId || selectedProjectId) {
-        console.log(`    Context:   ${formatPath(getLocalConfigPath(cwd), home)}`);
-    }
-    console.log("");
-    console.log(`  ${colors.bold("Usage:")}`);
-    if (!needsSkills || selectedAgents.includes("claude")) {
-        console.log(`    ${colors.brand("Claude Code:")} ${colors.highlight("/hmy #42")} or ${colors.highlight("/hmy-plan")} ${colors.dim("(create or execute plans)")}`);
-    }
-    if (selectedAgents.includes("codex")) {
-        console.log(`    ${colors.brand("Codex:")} ${colors.highlight("/prompts:hmy #42")}`);
+    if (createdNewAccount && selectedWorkspaceNameFromSignup) {
+        // New account: show board URL and next steps
+        const wsSlug = selectedWorkspaceNameFromSignup
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/(^-|-$)/g, "");
+        const projSlug = (selectedProjectNameFromSignup || "my-first-board")
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/(^-|-$)/g, "");
+        console.log("");
+        console.log(`  ${colors.bold("Your board:")} ${colors.highlight(`https://app.gethmy.com/${wsSlug}/${projSlug}`)}`);
+        console.log("");
+        console.log(`  ${colors.bold("Next steps:")}`);
+        console.log(`    1. Open Claude Code and say: ${colors.highlight('"Show me my board"')}`);
+        console.log(`    2. Create a card: ${colors.highlight('"Create a card called Auth token refresh"')}`);
+        console.log(`    3. Start the daemon: ${colors.highlight("npx @gethmy/agent")}`);
+        console.log("");
+        console.log(`  ${colors.dim("Happy shipping!")}`);
     }
-    if (selectedAgents.includes("cursor") ||
-        selectedAgents.includes("windsurf")) {
-        console.log(`    ${colors.brand("Cursor/Windsurf:")} MCP tools available automatically`);
+    else {
+        // Existing user: show config paths and usage
+        console.log("");
+        console.log(`  ${colors.bold("Configuration:")}`);
+        console.log(`    API key:   ${formatPath(getConfigPath(), home)}`);
+        if (needsSkills && selectedAgents.length > 0) {
+            console.log(`    Skills:    ${installMode === "global" ? "~/.agents/skills/ (global)" : ".claude/skills/ (local)"}`);
+        }
+        if (selectedWorkspaceId || selectedProjectId) {
+            console.log(`    Context:   ${formatPath(getLocalConfigPath(cwd), home)}`);
+        }
+        console.log("");
+        console.log(`  ${colors.bold("Usage:")}`);
+        if (!needsSkills || selectedAgents.includes("claude")) {
+            console.log(`    ${colors.brand("Claude Code:")} ${colors.highlight("/hmy #42")} or ${colors.highlight("/hmy-plan")} ${colors.dim("(create or execute plans)")}`);
+        }
+        if (selectedAgents.includes("codex")) {
+            console.log(`    ${colors.brand("Codex:")} ${colors.highlight("/prompts:hmy #42")}`);
+        }
+        if (selectedAgents.includes("cursor") ||
+            selectedAgents.includes("windsurf")) {
+            console.log(`    ${colors.brand("Cursor:")} MCP tools available automatically`);
+        }
+        console.log("");
+        console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
+        console.log(`  ${colors.dim("Need help? Visit https://app.gethmy.com/docs/mcp")}`);
     }
     console.log("");
-    console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
-    console.log(`  ${colors.dim("Need help? Visit https://app.gethmy.com/docs/mcp")}`);
-    console.log("");
 }