@mkacki98/chestnut-mcp 0.1.5 → 0.1.7

package/README.md

@@ -21,6 +21,10 @@ This will:
 - Prompt you to log in (if not already logged in)
 - Generate an access token
 - Save the token locally
+- **Ask if you want to enable automatic course suggestions globally**
+  - If enabled, adds instructions to `~/.claude/CLAUDE.md`
+  - Claude will proactively suggest courses across **all your projects**
+  - You can disable this later by removing the Chestnut section from `~/.claude/CLAUDE.md`
 
 ### 2. Configure Claude Code
 
@@ -46,7 +50,6 @@ Claude Code will now automatically suggest courses when it detects learning oppo
 - `npx chestnut-mcp auth` - Authenticate with Chestnut
 - `npx chestnut-mcp status` - Check authentication status
 - `npx chestnut-mcp logout` - Clear saved credentials
-- `npx chestnut-mcp config` - View/set configuration
 
 ## Development
 
@@ -63,11 +66,14 @@ npm run dev
 
 ## How It Works
 
-1. Claude Code detects you're using a suboptimal pattern
-2. On session end, it calls the `create_pending_course` tool
-3. Tool sends suggestion to your Chestnut account
-4. You see the suggestion in your dashboard
-5. Click "Start Course" to begin learning
+1. During auth, you opt-in to global course suggestions
+2. Claude Code (with global instructions) proactively detects learning opportunities
+3. When you could benefit from learning something, Claude calls the `create_pending_course` tool
+4. Tool sends suggestion to your Chestnut account
+5. You see the suggestion in your dashboard at https://chestnut.so
+6. Click "Start Course" to begin learning
+
+**Note:** If you enabled global suggestions during auth, Claude will suggest courses across all your projects. To disable, remove the "Chestnut Learning Integration" section from `~/.claude/CLAUDE.md`.
 
 ## License
 

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { initiateOAuth } from "./oauth.js";
-import { loadAccessToken, clearAccessToken, getChestnutUrl, setChestnutUrl } from "./config.js";
+import { loadAccessToken, clearAccessToken, getChestnutUrl } from "./config.js";
 const args = process.argv.slice(2);
 const command = args[0];
 async function main() {
@@ -24,24 +24,12 @@ async function main() {
             clearAccessToken();
             console.log("✓ Logged out successfully");
             break;
-        case "config":
-            if (args[1] === "set-url" && args[2]) {
-                setChestnutUrl(args[2]);
-                console.log(`✓ Chestnut URL set to: ${args[2]}`);
-            }
-            else {
-                console.log(`Current Chestnut URL: ${getChestnutUrl()}`);
-                console.log("\nTo change URL:");
-                console.log("  npx chestnut-mcp config set-url https://your-url.com");
-            }
-            break;
         default:
             console.log("Chestnut MCP Server");
             console.log("\nCommands:");
             console.log("  auth           Authenticate with Chestnut");
             console.log("  status         Check authentication status");
             console.log("  logout         Clear saved token");
-            console.log("  config         View/set configuration");
             console.log("\nFor Claude Code integration, add to your config:");
             console.log(JSON.stringify({
                 mcpServers: {

package/dist/config.d.ts

@@ -1,6 +1,5 @@
 interface Config {
     accessToken?: string;
-    chestnutUrl?: string;
 }
 export declare function loadConfig(): Config;
 export declare function saveConfig(config: Config): void;
@@ -8,5 +7,4 @@ export declare function loadAccessToken(): string | null;
 export declare function saveAccessToken(token: string): void;
 export declare function clearAccessToken(): void;
 export declare function getChestnutUrl(): string;
-export declare function setChestnutUrl(url: string): void;
 export {};

package/dist/config.js

@@ -36,11 +36,5 @@ export function clearAccessToken() {
     saveConfig(config);
 }
 export function getChestnutUrl() {
-    const config = loadConfig();
-    return config.chestnutUrl || "https://chestnut.so";
-}
-export function setChestnutUrl(url) {
-    const config = loadConfig();
-    config.chestnutUrl = url;
-    saveConfig(config);
+    return "https://chestnut.so";
 }

package/dist/oauth.js

@@ -1,6 +1,9 @@
 import open from "open";
 import { saveAccessToken, getChestnutUrl } from "./config.js";
 import readline from "readline";
+import fs from "fs";
+import path from "path";
+import os from "os";
 export async function initiateOAuth() {
     const chestnutUrl = getChestnutUrl();
     const authUrl = `${chestnutUrl}/integrations/claude_code/authorize`;
@@ -37,9 +40,18 @@ export async function initiateOAuth() {
             saveAccessToken(token);
             console.log("✓ Authenticated successfully with Chestnut!");
             console.log(`Token saved to: ${process.env.HOME}/.chestnut-mcp/config.json\n`);
+            // Prompt to configure global Claude instructions
+            await configureGlobalClaude();
         }
         else {
-            console.log("❌ Invalid token. Please try again.");
+            console.log(`❌ Invalid token. Server returned status: ${response.status}`);
+            try {
+                const body = await response.text();
+                console.log(`Response: ${body}`);
+            }
+            catch {
+                console.log("(Could not read response body)");
+            }
         }
     }
     catch (error) {
@@ -58,3 +70,51 @@ async function promptForToken() {
         });
     });
 }
+async function promptForYesNo(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            resolve(normalized === "y" || normalized === "yes");
+        });
+    });
+}
+async function configureGlobalClaude() {
+    const claudeDir = path.join(os.homedir(), ".claude");
+    const claudeMdPath = path.join(claudeDir, "CLAUDE.md");
+    const chestnutInstructions = `
+# Chestnut Learning Integration
+When you notice I could benefit from learning something:
+- Proactively use the \`create_pending_course\` MCP tool
+- Examples: using outdated patterns, reinventing features, common mistakes, suboptimal approaches
+- Run it also when I explicitly ask you to suggest a course
+- Keep suggestions relevant and actionable
+`;
+    // Check if instructions already exist
+    if (fs.existsSync(claudeMdPath)) {
+        const content = fs.readFileSync(claudeMdPath, "utf-8");
+        if (content.includes("Chestnut Learning Integration")) {
+            console.log("ℹ️  Global Claude instructions already configured for Chestnut.");
+            return;
+        }
+    }
+    console.log("\n📚 Chestnut can automatically suggest courses when Claude notices learning opportunities.");
+    console.log("⚠️  This will be enabled GLOBALLY for all your Claude Code sessions.\n");
+    const enableGlobal = await promptForYesNo("Enable automatic course suggestions globally? (y/n): ");
+    if (!enableGlobal) {
+        console.log("⏭️  Skipped global configuration. You can enable it later in ~/.claude/CLAUDE.md");
+        return;
+    }
+    // Ensure ~/.claude directory exists
+    if (!fs.existsSync(claudeDir)) {
+        fs.mkdirSync(claudeDir, { recursive: true });
+    }
+    // Append or create CLAUDE.md
+    fs.appendFileSync(claudeMdPath, chestnutInstructions);
+    console.log(`✓ Global instructions added to: ${claudeMdPath}`);
+    console.log("  Claude will now proactively suggest Chestnut courses across all projects.\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mkacki98/chestnut-mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "MCP server for Chestnut learning platform integration",
   "type": "module",
   "main": "./dist/index.js",