devto-mcp 0.1.9 → 0.2.1

package/dist/cli.js

@@ -7,13 +7,12 @@
  *   devto login                          Authenticate with your DevTo API key
  *   devto logout                         Clear global credentials
  *   devto status                         Show current connection status
- *   devto init                           Auto-configure Claude Code MCP config
+ *   devto init                           Link this project to DevTo
+ *   devto unlink                         Unlink this project from DevTo
  *   devto doctor                         Test full connection chain
  *   devto sync                           Re-sync workspace configuration
  *   devto verbose                        Toggle verbose mode
  *   devto config set anthropic-key <key> Store Anthropic API key
- *   devto uninstall                      Remove DevTo from this project
- *   devto uninstall --purge              Remove DevTo from this project + global config
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -55,6 +54,19 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const config_1 = require("./config");
 const command = process.argv[2];
+const NO_PROJECT_MESSAGE = `\nNo project linked in this directory.\nRun \`devto init\` to link this project to a DevTo workspace.\n`;
+/**
+ * Require .devto.json in the directory tree.
+ * If not found, print message and exit. Used by status, doctor, sync.
+ */
+function requireProjectJson() {
+    const projectJson = (0, config_1.findProjectJson)();
+    if (!projectJson) {
+        console.log(NO_PROJECT_MESSAGE);
+        process.exit(1);
+    }
+    return projectJson;
+}
 async function prompt(question, hidden = false) {
     return new Promise((resolve) => {
         const rl = readline.createInterface({
@@ -99,7 +111,7 @@ async function validateKey(apiKey) {
         const res = await fetch(`${apiUrl}/api/v1/status`, {
             headers: {
                 Authorization: `Bearer ${apiKey}`,
-                "X-DevTo-Version": "0.1.9",
+                "X-DevTo-Version": config_1.VERSION,
             },
         });
         // 200 = valid key, 401 = invalid
@@ -110,8 +122,38 @@ async function validateKey(apiKey) {
         return true;
     }
 }
+/**
+ * Fetch workspaces for a given API key.
+ * Returns array of { id, name, workspaceUrl, projectKey, providerType }.
+ */
+async function fetchWorkspaces(apiKey) {
+    const apiUrl = process.env.DEVTO_API_URL ?? "https://api.devto.ai";
+    try {
+        const res = await fetch(`${apiUrl}/api/v1/workspaces`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "X-DevTo-Version": config_1.VERSION,
+            },
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        return (data.workspaces ?? []).map((w) => ({
+            id: w.id,
+            name: w.name,
+            workspaceUrl: w.workspace_url,
+            projectKey: w.workspace_project_key,
+            providerType: w.provider_type,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
 async function login() {
-    console.log("\nDevTo Login\n");
+    console.log("\nDevTo Login (global)\n");
+    console.log("Note: For per-project isolation, use `devto init` instead.");
+    console.log("      `devto login` sets a global fallback key.\n");
     console.log("Get your API key from: https://devto.ai/dashboard/keys\n");
     const apiKey = await prompt("Paste your API key: ", true);
     if (!apiKey || !apiKey.startsWith("devto_")) {
@@ -148,7 +190,7 @@ async function login() {
     else {
         console.log("\nSkipped. You can set it later: devto config set anthropic-key sk-ant-xxxx\n");
     }
-    console.log("Next step: run `devto init` to configure Claude Code MCP.");
+    console.log("Next step: run `devto init` in your project directory.");
     console.log("Run `devto status` to verify your connection.\n");
 }
 async function logout() {
@@ -156,39 +198,61 @@ async function logout() {
     if (fs.existsSync(configDir)) {
         fs.rmSync(configDir, { recursive: true, force: true });
         console.log("\nLogged out. Removed ~/.devto credentials.");
-        console.log("Note: Project .mcp.json files still have embedded keys — MCP servers will keep working.");
-        console.log("Run `devto uninstall` in a project to remove it from that project.\n");
+        console.log("Note: Project .devto.json files are untouched — run `devto unlink` per project to remove them.\n");
     }
     else {
         console.log("\nNo credentials found. Already logged out.\n");
     }
 }
 async function status() {
-    const config = (0, config_1.readConfig)();
-    if (!config) {
-        console.log("\nNot logged in. Run `devto login` to authenticate.\n");
-        process.exit(1);
-    }
+    const projectJson = requireProjectJson();
+    const projectConfig = (0, config_1.readProjectConfig)();
+    const globalConfig = (0, config_1.readConfig)();
+    const resolved = projectConfig
+        ? { config: projectConfig, source: "project" }
+        : globalConfig
+            ? { config: globalConfig, source: "global" }
+            : null;
     console.log("\nDevTo Status");
     console.log("────────────");
+    console.log(`Project config: ${path.join(projectJson.dir, ".devto.json")}`);
+    console.log(`  Workspace: ${projectJson.config.workspaceUrl}`);
+    console.log(`  Project:   ${projectJson.config.projectKey}`);
+    console.log(`  Provider:  ${projectJson.config.provider}`);
+    console.log();
+    if (!resolved) {
+        console.log("Auth: No API key found.");
+        console.log("  Run `devto init` to set up credentials for this project.\n");
+        process.exit(1);
+    }
+    const { config, source } = resolved;
+    if (source === "global") {
+        console.log("Auth source: global (~/.devto/config.json)");
+    }
+    else {
+        console.log("Auth source: project (.devto/config.json)");
+    }
     console.log(`API URL: ${config.api_url}`);
     console.log(`API Key: ${config.api_key.slice(0, 12)}...`);
     // Anthropic key status
-    try {
+    const hasAnthropic = config.anthropic_key || (() => { try {
         (0, config_1.getAnthropicKey)();
-        console.log("Anthropic Key: configured");
+        return true;
     }
     catch {
-        console.log("Anthropic Key: missing (run `devto config set anthropic-key sk-ant-xxxx`)");
-    }
+        return false;
+    } })();
+    console.log(`Anthropic Key: ${hasAnthropic ? "configured" : "missing (run `devto config set anthropic-key sk-ant-xxxx`)"}`);
     process.stdout.write("Connection: ");
     try {
-        const res = await fetch(`${config.api_url}/api/v1/status`, {
-            headers: {
-                Authorization: `Bearer ${config.api_key}`,
-                "X-DevTo-Version": "0.1.9",
-            },
-        });
+        const headers = {
+            Authorization: `Bearer ${config.api_key}`,
+            "X-DevTo-Version": config_1.VERSION,
+        };
+        if (projectJson.config.workspaceId) {
+            headers["X-DevTo-Workspace"] = projectJson.config.workspaceId;
+        }
+        const res = await fetch(`${config.api_url}/api/v1/status`, { headers });
         if (res.ok) {
             const data = (await res.json());
             console.log("Connected");
@@ -201,7 +265,7 @@ async function status() {
         }
         else if (res.status === 401) {
             console.log("Invalid API key");
-            console.log("\nRun `devto login` to re-authenticate.");
+            console.log("\nRun `devto init` to re-authenticate.");
         }
         else {
             console.log(`Error (${res.status})`);
@@ -213,64 +277,172 @@ async function status() {
     console.log();
 }
 async function init() {
-    console.log("\nDevTo Init — Configure Claude Code MCP\n");
-    const config = (0, config_1.readConfig)();
-    const apiKey = config?.api_key;
-    if (!apiKey) {
-        console.error("No API key found. Run `devto login` first, then re-run `devto init`.\n");
-        process.exit(1);
+    console.log("\nDevTo Init — Link this project to DevTo\n");
+    const globalConfig = (0, config_1.readConfig)();
+    const existingProject = (0, config_1.readProjectConfig)();
+    const existingJson = (0, config_1.findProjectJson)(process.cwd());
+    const apiUrl = process.env.DEVTO_API_URL ?? globalConfig?.api_url ?? "https://api.devto.ai";
+    // ── Step 1: Get API key ──────────────────────────────────────────────
+    let apiKey;
+    if (existingProject?.api_key) {
+        const reuse = await prompt(`This project already has an API key (${existingProject.api_key.slice(0, 12)}...). Use it? (y/n): `);
+        if (reuse.toLowerCase() === "y" || reuse.toLowerCase() === "yes") {
+            apiKey = existingProject.api_key;
+        }
+        else {
+            apiKey = await promptForApiKey();
+        }
     }
-    // Check for Anthropic key
-    let anthropicKey;
-    try {
-        anthropicKey = (0, config_1.getAnthropicKey)();
+    else if (globalConfig?.api_key) {
+        const reuse = await prompt(`Use your global API key (${globalConfig.api_key.slice(0, 12)}...)? (y/n): `);
+        if (reuse.toLowerCase() === "y" || reuse.toLowerCase() === "yes") {
+            apiKey = globalConfig.api_key;
+        }
+        else {
+            apiKey = await promptForApiKey();
+        }
     }
-    catch {
-        // No Anthropic key yet — skip
+    else {
+        console.log("Get your API key from: https://devto.ai/dashboard/keys\n");
+        apiKey = await promptForApiKey();
     }
-    // Remove existing devto server first (ignore errors if not present)
-    console.log("Registering DevTo MCP server with Claude Code...\n");
-    const { execSync } = require("child_process");
-    try {
-        execSync("claude mcp remove devto", { stdio: "ignore" });
+    // Validate the key
+    process.stdout.write("Validating... ");
+    const valid = await validateKey(apiKey);
+    if (!valid) {
+        console.error("\nInvalid API key. Check your key at https://devto.ai/dashboard/keys\n");
+        process.exit(1);
     }
-    catch {
-        // Not present — fine
+    console.log("OK");
+    // ── Step 2: Select workspace/project ─────────────────────────────────
+    let workspaceUrl;
+    let projectKey;
+    let provider;
+    let workspaceId;
+    // Try to fetch workspaces from the API
+    console.log("\nFetching your workspaces...");
+    const workspaces = await fetchWorkspaces(apiKey);
+    if (workspaces.length > 0) {
+        console.log(`\nFound ${workspaces.length} workspace(s):\n`);
+        workspaces.forEach((ws, i) => {
+            console.log(`  ${i + 1}. ${ws.name || ws.workspaceUrl} — ${ws.projectKey} (${ws.providerType})`);
+        });
+        let selected;
+        if (workspaces.length === 1) {
+            const confirm = await prompt(`\nUse this workspace? (y/n): `);
+            if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
+                console.log("\nYou can connect a different workspace at https://devto.ai/dashboard/settings\n");
+                process.exit(0);
+            }
+            selected = workspaces[0];
+        }
+        else {
+            const choice = await prompt(`\nSelect workspace (1-${workspaces.length}): `);
+            const idx = parseInt(choice, 10) - 1;
+            if (isNaN(idx) || idx < 0 || idx >= workspaces.length) {
+                console.error("\nInvalid selection.\n");
+                process.exit(1);
+            }
+            selected = workspaces[idx];
+        }
+        workspaceUrl = selected.workspaceUrl;
+        projectKey = selected.projectKey;
+        provider = selected.providerType;
+        workspaceId = selected.id;
+    }
+    else {
+        // No workspaces found — prompt manually
+        console.log("\nNo workspaces found. Enter workspace details manually.\n");
+        workspaceUrl = await prompt("Workspace URL (e.g. https://yourcompany.atlassian.net): ");
+        if (!workspaceUrl) {
+            console.error("\nWorkspace URL is required.\n");
+            process.exit(1);
+        }
+        projectKey = await prompt("Project key (e.g. ENG): ");
+        if (!projectKey) {
+            console.error("\nProject key is required.\n");
+            process.exit(1);
+        }
+        provider = await prompt("Provider (jira/linear/github/shortcut) [jira]: ") || "jira";
     }
-    // Use `claude mcp add-json` to register properly — handles quoting reliably
+    // ── Step 3: Check for Anthropic key ──────────────────────────────────
+    let anthropicKey = existingProject?.anthropic_key;
+    if (!anthropicKey) {
+        try {
+            anthropicKey = (0, config_1.getAnthropicKey)();
+        }
+        catch {
+            // No Anthropic key yet — skip
+        }
+    }
+    // ── Step 4: Write .devto.json (project config) ──────────────────────
+    (0, config_1.writeProjectJson)({
+        workspaceUrl,
+        projectKey,
+        provider,
+        workspaceId,
+    });
+    console.log("\nCreated .devto.json");
+    // Ensure .devto.json is gitignored
+    ensureGitignore(".devto.json");
+    // ── Step 5: Write .devto/config.json (credentials) ──────────────────
+    (0, config_1.writeProjectConfig)({
+        api_key: apiKey,
+        api_url: apiUrl,
+        anthropic_key: anthropicKey,
+        workspace_id: workspaceId,
+    });
+    // Ensure .devto/ is gitignored
+    ensureGitignore(".devto/");
+    console.log("Created .devto/config.json");
+    // ── Step 6: Register in ~/.devto/projects.json ──────────────────────
+    (0, config_1.registerProject)({
+        path: process.cwd(),
+        workspaceUrl,
+        projectKey,
+        provider,
+    });
+    console.log("Registered in ~/.devto/projects.json");
+    // ── Step 7: Write .mcp.json (Claude Code config) ────────────────────
     const isWindows = process.platform === "win32";
     const envObj = { DEVTO_API_KEY: apiKey };
     if (anthropicKey)
         envObj.DEVTO_ANTHROPIC_KEY = anthropicKey;
-    const jsonConfig = JSON.stringify({
+    if (workspaceId)
+        envObj.DEVTO_WORKSPACE_ID = workspaceId;
+    const mcpServerConfig = {
         command: isWindows ? "cmd" : "npx",
         args: isWindows ? ["/c", "npx", "-y", "devto-mcp"] : ["-y", "devto-mcp"],
         env: envObj,
-    });
+    };
+    const mcpJsonPath = path.join(process.cwd(), ".mcp.json");
+    let mcpConfig = {};
+    if (fs.existsSync(mcpJsonPath)) {
+        try {
+            mcpConfig = JSON.parse(fs.readFileSync(mcpJsonPath, "utf-8"));
+        }
+        catch {
+            // Corrupt file — start fresh
+        }
+    }
+    if (!mcpConfig.mcpServers)
+        mcpConfig.mcpServers = {};
+    mcpConfig.mcpServers.devto = mcpServerConfig;
+    fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+    console.log("MCP config written to .mcp.json");
+    // Also remove any user-level devto MCP config to avoid conflicts
     try {
         const { execSync } = require("child_process");
-        // Use single quotes in bash, escaped double quotes in cmd
-        const escaped = isWindows
-            ? jsonConfig.replace(/"/g, '\\"')
-            : jsonConfig;
-        const quote = isWindows ? '"' : "'";
-        execSync(`claude mcp add-json devto ${quote}${escaped}${quote}`, { stdio: "inherit" });
-        console.log("\nDevTo MCP server registered successfully.");
-        console.log(`API key (${apiKey.slice(0, 12)}...) configured.`);
+        execSync("claude mcp remove devto", { stdio: "ignore" });
     }
     catch {
-        console.error("\nFailed to register via Claude CLI. Is Claude Code installed?");
-        console.error("Install: https://docs.anthropic.com/en/docs/claude-code\n");
-        console.error("As a fallback, you can add manually via:");
-        if (isWindows) {
-            console.error(`  claude mcp add -e DEVTO_API_KEY=${apiKey} devto -- cmd /c npx -y devto-mcp`);
-        }
-        else {
-            console.error(`  claude mcp add -e DEVTO_API_KEY=${apiKey} devto -- npx -y devto-mcp`);
-        }
-        process.exit(1);
+        // Not registered at user level — fine
     }
-    // Warn if Anthropic key is missing
+    console.log(`\n── Project linked ──────────────────────────────`);
+    console.log(`Workspace: ${workspaceUrl}`);
+    console.log(`Project:   ${projectKey}`);
+    console.log(`Provider:  ${provider}`);
+    console.log(`API key:   ${apiKey.slice(0, 12)}...`);
     if (!anthropicKey) {
         console.log("\nNote: Anthropic API key not configured.");
         console.log("  AI plan generation (create_plan) requires an Anthropic key.");
@@ -280,9 +452,90 @@ async function init() {
     }
     console.log("\nRestart Claude Code to pick up the changes.\n");
 }
+async function unlink() {
+    console.log("\nDevTo Unlink — Remove this project from DevTo\n");
+    const projectJson = (0, config_1.findProjectJson)(process.cwd());
+    const devtoJsonPath = path.join(process.cwd(), ".devto.json");
+    const devtoConfigDir = path.join(process.cwd(), ".devto");
+    if (!projectJson && !fs.existsSync(devtoJsonPath) && !fs.existsSync(devtoConfigDir)) {
+        console.log("This project is not linked to DevTo.\n");
+        return;
+    }
+    const confirm = await prompt("Remove DevTo configuration from this project? (y/n): ");
+    if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
+        console.log("Cancelled.\n");
+        return;
+    }
+    // Remove .devto.json
+    if (fs.existsSync(devtoJsonPath)) {
+        fs.unlinkSync(devtoJsonPath);
+        console.log("Removed .devto.json");
+    }
+    // Remove .devto/ directory
+    if (fs.existsSync(devtoConfigDir)) {
+        fs.rmSync(devtoConfigDir, { recursive: true, force: true });
+        console.log("Removed .devto/");
+    }
+    // Remove devto entry from .mcp.json
+    const mcpJsonPath = path.join(process.cwd(), ".mcp.json");
+    if (fs.existsSync(mcpJsonPath)) {
+        try {
+            const raw = fs.readFileSync(mcpJsonPath, "utf-8");
+            const mcpConfig = JSON.parse(raw);
+            if (mcpConfig.mcpServers?.devto) {
+                delete mcpConfig.mcpServers.devto;
+                fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+                console.log("Removed devto from .mcp.json");
+            }
+        }
+        catch {
+            // Skip corrupt config
+        }
+    }
+    // Unregister from ~/.devto/projects.json
+    const removed = (0, config_1.unregisterProject)(process.cwd());
+    if (removed) {
+        console.log("Removed from ~/.devto/projects.json");
+    }
+    console.log("\nProject unlinked. Global credentials (~/.devto/config.json) are untouched.");
+    console.log("Restart Claude Code to apply changes.\n");
+}
+async function promptForApiKey() {
+    const apiKey = await prompt("Paste your API key: ", true);
+    if (!apiKey || !apiKey.startsWith("devto_")) {
+        console.error("\nInvalid key format. DevTo API keys start with 'devto_'.\nGet your key at https://devto.ai/dashboard/keys\n");
+        process.exit(1);
+    }
+    return apiKey;
+}
+function ensureGitignore(entry) {
+    const gitignorePath = path.join(process.cwd(), ".gitignore");
+    try {
+        if (fs.existsSync(gitignorePath)) {
+            const content = fs.readFileSync(gitignorePath, "utf-8");
+            if (!content.includes(entry)) {
+                const label = entry === ".devto.json" ? "DevTo project config" : "DevTo credentials (contains API keys)";
+                fs.appendFileSync(gitignorePath, `\n# ${label}\n${entry}\n`);
+            }
+        }
+        else {
+            const label = entry === ".devto.json" ? "DevTo project config" : "DevTo credentials (contains API keys)";
+            fs.writeFileSync(gitignorePath, `# ${label}\n${entry}\n`);
+        }
+    }
+    catch {
+        console.log(`  Warning: Could not update .gitignore — make sure ${entry} is not committed.`);
+    }
+}
 async function doctor() {
     console.log("\nDevTo Doctor — Connection Diagnostics\n");
-    const config = (0, config_1.readConfig)();
+    const projectJson = requireProjectJson();
+    const resolved = (0, config_1.resolveConfig)();
+    const config = resolved?.config ?? null;
+    process.stdout.write("Project config (.devto.json) ... ");
+    console.log(`OK (${path.join(projectJson.dir, ".devto.json")})`);
+    console.log(`  Workspace: ${projectJson.config.workspaceUrl}`);
+    console.log(`  Project: ${projectJson.config.projectKey} (${projectJson.config.provider})`);
     // 1. Check DevTo API reachable
     process.stdout.write("DevTo API reachable ... ");
     const apiUrl = config?.api_url ?? (0, config_1.getApiUrl)();
@@ -290,7 +543,7 @@ async function doctor() {
         const res = await fetch(`${apiUrl}/api/v1/status`, {
             headers: {
                 ...(config?.api_key ? { Authorization: `Bearer ${config.api_key}` } : {}),
-                "X-DevTo-Version": "0.1.9",
+                "X-DevTo-Version": config_1.VERSION,
             },
         });
         if (res.ok) {
@@ -316,7 +569,7 @@ async function doctor() {
             const res = await fetch(`${apiUrl}/api/v1/status`, {
                 headers: {
                     Authorization: `Bearer ${config.api_key}`,
-                    "X-DevTo-Version": "0.1.9",
+                    "X-DevTo-Version": config_1.VERSION,
                 },
             });
             if (res.status === 401) {
@@ -344,7 +597,7 @@ async function doctor() {
             const res = await fetch(`${apiUrl}/api/v1/status`, {
                 headers: {
                     Authorization: `Bearer ${config.api_key}`,
-                    "X-DevTo-Version": "0.1.9",
+                    "X-DevTo-Version": config_1.VERSION,
                 },
             });
             if (res.ok) {
@@ -402,6 +655,7 @@ async function doctor() {
 }
 async function sync() {
     console.log("\nDevTo Sync — Workspace Configuration Discovery\n");
+    requireProjectJson();
     const config = (0, config_1.readConfig)();
     if (!config?.api_key) {
         console.log("Not logged in. Run `devto login` first.\n");
@@ -415,7 +669,7 @@ async function sync() {
             headers: {
                 "Content-Type": "application/json",
                 Authorization: `Bearer ${config.api_key}`,
-                "X-DevTo-Version": "0.1.9",
+                "X-DevTo-Version": config_1.VERSION,
             },
         });
         if (!res.ok) {
@@ -464,64 +718,6 @@ async function configSet() {
     console.log(`Key: ${value.slice(0, 12)}...`);
     console.log("Run `devto init` to embed it in your project's MCP config.\n");
 }
-async function uninstall() {
-    const purge = process.argv[3] === "--purge";
-    if (purge) {
-        console.log("\nDevTo Uninstall (full purge)\n");
-        const confirm = await prompt("This will remove DevTo MCP server AND delete global credentials (~/.devto). Continue? (y/n): ");
-        if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
-            console.log("Cancelled.\n");
-            return;
-        }
-    }
-    else {
-        console.log("\nDevTo Uninstall\n");
-        const confirm = await prompt("Remove DevTo MCP server from Claude Code? (y/n): ");
-        if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
-            console.log("Cancelled.\n");
-            return;
-        }
-    }
-    // Remove via Claude CLI
-    const { spawnSync } = require("child_process");
-    try {
-        spawnSync("claude", ["mcp", "remove", "devto"], { stdio: "inherit", shell: true });
-        console.log("Removed DevTo MCP server from Claude Code.");
-    }
-    catch {
-        console.log("Could not remove via Claude CLI (may not be registered).");
-    }
-    // Also clean up .mcp.json if it has a devto entry (legacy)
-    const mcpJsonPath = path.join(process.cwd(), ".mcp.json");
-    if (fs.existsSync(mcpJsonPath)) {
-        try {
-            const raw = fs.readFileSync(mcpJsonPath, "utf-8");
-            const mcpConfig = JSON.parse(raw);
-            if (mcpConfig.mcpServers?.devto) {
-                delete mcpConfig.mcpServers.devto;
-                fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
-                console.log(`Also removed devto from: ${mcpJsonPath}`);
-            }
-        }
-        catch {
-            // Skip corrupt config
-        }
-    }
-    // Only with --purge: remove global ~/.devto config
-    if (purge) {
-        const configDir = path.join(os.homedir(), ".devto");
-        if (fs.existsSync(configDir)) {
-            fs.rmSync(configDir, { recursive: true, force: true });
-            console.log("Removed ~/.devto global credentials.");
-        }
-        console.log("\nFull purge complete. To finish, run: npm uninstall -g devto-mcp\n");
-    }
-    else {
-        console.log("\nDevTo removed from this project.");
-        console.log("Your global credentials (~/.devto) are untouched — other projects still work.");
-        console.log("Restart Claude Code to apply changes.\n");
-    }
-}
 function printHelp() {
     console.log(`
 DevTo CLI — AI-powered work management
@@ -529,26 +725,26 @@ DevTo CLI — AI-powered work management
 Usage:
   devto login                          Authenticate with your DevTo API key
   devto logout                         Clear global credentials (~/.devto)
-  devto status                         Show connection status
-  devto init                           Auto-configure Claude Code MCP config
+  devto status                         Show connection status and active project
+  devto init                           Link this project to DevTo
+  devto unlink                         Unlink this project from DevTo
   devto doctor                         Test full connection chain
   devto sync                           Re-sync workspace configuration
   devto verbose                        Toggle verbose mode
   devto config set anthropic-key <key> Store Anthropic API key
-  devto uninstall                      Remove DevTo from this project
-  devto uninstall --purge              Remove from project + delete global credentials
   devto help                           Show this help message
   devto --version                      Show installed version
 
-After logging in, run \`devto init\` in your project to add DevTo to .mcp.json.
+Setup:
+  1. npm install -g devto-mcp          Install globally (once)
+  2. devto login                       Save your API key
+  3. devto init                        Link project, create .devto.json + .mcp.json
+  4. Restart Claude Code
 
-Manual setup (add to your project's .mcp.json):
-
-  Windows:
-  { "mcpServers": { "devto": { "command": "cmd", "args": ["/c", "npx", "-y", "devto-mcp"], "env": { "DEVTO_API_KEY": "your-key" } } } }
-
-  macOS/Linux:
-  { "mcpServers": { "devto": { "command": "npx", "args": ["-y", "devto-mcp"], "env": { "DEVTO_API_KEY": "your-key" } } } }
+Per-project config (.devto.json):
+  Created by \`devto init\`. Contains workspace URL, project key, and provider.
+  Add .devto.json to .gitignore (devto init does this automatically).
+  To disconnect a project: \`devto unlink\`
 `);
 }
 async function main() {
@@ -569,6 +765,10 @@ async function main() {
         case "--init":
             await init();
             break;
+        case "unlink":
+        case "--unlink":
+            await unlink();
+            break;
         case "doctor":
         case "--doctor":
             await doctor();
@@ -585,13 +785,9 @@ async function main() {
         case "--config":
             await configSet();
             break;
-        case "uninstall":
-        case "--uninstall":
-            await uninstall();
-            break;
         case "--version":
         case "-v":
-            console.log(`devto-mcp v${require("../package.json").version}`);
+            console.log(`devto-mcp v${config_1.VERSION}`);
             break;
         case "help":
         case "--help":