harmony-mcp 1.3.0 → 1.3.1

package/README.md

@@ -98,10 +98,13 @@ harmony-mcp init               # Initialize for AI agents (interactive)
 harmony-mcp init --all         # Configure all supported agents
 harmony-mcp init --detect      # Auto-detect and configure installed agents
 harmony-mcp init --agent X Y   # Configure specific agents
-harmony-mcp status             # Show current config
+harmony-mcp init -w WS -p PROJ # Initialize with local workspace/project context
+harmony-mcp status             # Show current config (global and local)
 harmony-mcp reset              # Clear configuration
-harmony-mcp set-workspace ID   # Set active workspace
-harmony-mcp set-project ID     # Set active project
+harmony-mcp set-workspace ID   # Set active workspace (global)
+harmony-mcp set-workspace ID -l # Set active workspace (local project)
+harmony-mcp set-project ID     # Set active project (global)
+harmony-mcp set-project ID -l  # Set active project (local project)
 harmony-mcp serve              # Start MCP server
 ```
 
@@ -233,7 +236,9 @@ curl -X GET "https://gethmy.com/api/workspaces" \
 
 ## Configuration
 
-Your configuration is stored in `~/.harmony-mcp/config.json`:
+### Global Configuration
+
+Your global configuration is stored in `~/.harmony-mcp/config.json`:
 
 ```json
 {
@@ -244,6 +249,66 @@ Your configuration is stored in `~/.harmony-mcp/config.json`:
 }
 ```
 
+### Local Project Configuration
+
+For multi-project workflows, you can set project-specific context using local configuration. This is stored in `.harmony-mcp.json` in your project root:
+
+```json
+{
+  "workspaceId": "uuid-here",
+  "projectId": "uuid-here"
+}
+```
+
+**Priority**: Local config overrides global config for workspace and project context.
+
+**Security**: API key is never stored locally (only in global config) to prevent accidental commits.
+
+#### Setting Local Context
+
+```bash
+# During initialization
+harmony-mcp init --workspace <ws-id> --project <proj-id>
+
+# Or separately
+harmony-mcp set-workspace <id> --local
+harmony-mcp set-project <id> --local
+```
+
+#### Viewing Configuration
+
+```bash
+harmony-mcp status
+```
+
+Example output:
+
+```
+Status: Configured
+API Key: hmy_abc1...
+API URL: https://gethmy.com/api
+
+Global Context:
+  Workspace: <global-ws-id>
+  Project: <global-proj-id>
+
+Local Context (.harmony-mcp.json):
+  Workspace: <local-ws-id>
+  Project: <local-proj-id>
+
+Active (effective):
+  Workspace: <local-ws-id>  ← local
+  Project: <local-proj-id>  ← local
+```
+
+#### Recommended .gitignore
+
+Add this to prevent accidentally committing local config:
+
+```
+.harmony-mcp.json
+```
+
 ## Architecture
 
 ```

package/dist/cli.js

@@ -25234,12 +25234,16 @@ import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 var DEFAULT_API_URL = "https://gethmy.com/api";
+var LOCAL_CONFIG_FILENAME = ".harmony-mcp.json";
 function getConfigDir() {
   return join2(homedir2(), ".harmony-mcp");
 }
 function getConfigPath() {
   return join2(getConfigDir(), "config.json");
 }
+function getLocalConfigPath(cwd) {
+  return join2(cwd || process.cwd(), LOCAL_CONFIG_FILENAME);
+}
 function loadConfig() {
   const configPath = getConfigPath();
   if (!existsSync2(configPath)) {
@@ -25278,6 +25282,39 @@ function saveConfig(config2) {
   const newConfig = { ...existingConfig, ...config2 };
   writeFileSync2(configPath, JSON.stringify(newConfig, null, 2), { mode: 384 });
 }
+function loadLocalConfig(cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  if (!existsSync2(localConfigPath)) {
+    return null;
+  }
+  try {
+    const data = readFileSync2(localConfigPath, "utf-8");
+    const config2 = JSON.parse(data);
+    return {
+      workspaceId: config2.workspaceId || null,
+      projectId: config2.projectId || null
+    };
+  } catch {
+    return null;
+  }
+}
+function saveLocalConfig(config2, cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  const existingConfig = loadLocalConfig(cwd) || {
+    workspaceId: null,
+    projectId: null
+  };
+  const newConfig = { ...existingConfig, ...config2 };
+  const cleanConfig = {};
+  if (newConfig.workspaceId)
+    cleanConfig.workspaceId = newConfig.workspaceId;
+  if (newConfig.projectId)
+    cleanConfig.projectId = newConfig.projectId;
+  writeFileSync2(localConfigPath, JSON.stringify(cleanConfig, null, 2));
+}
+function hasLocalConfig(cwd) {
+  return existsSync2(getLocalConfigPath(cwd));
+}
 function getApiKey() {
   const config2 = loadConfig();
   if (!config2.apiKey) {
@@ -25290,16 +25327,32 @@ function getApiUrl() {
   const config2 = loadConfig();
   return config2.apiUrl;
 }
-function setActiveWorkspace(workspaceId) {
-  saveConfig({ activeWorkspaceId: workspaceId });
+function setActiveWorkspace(workspaceId, options) {
+  if (options?.local) {
+    saveLocalConfig({ workspaceId }, options.cwd);
+  } else {
+    saveConfig({ activeWorkspaceId: workspaceId });
+  }
 }
-function setActiveProject(projectId) {
-  saveConfig({ activeProjectId: projectId });
+function setActiveProject(projectId, options) {
+  if (options?.local) {
+    saveLocalConfig({ projectId }, options.cwd);
+  } else {
+    saveConfig({ activeProjectId: projectId });
+  }
 }
-function getActiveWorkspaceId() {
+function getActiveWorkspaceId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.workspaceId) {
+    return localConfig.workspaceId;
+  }
   return loadConfig().activeWorkspaceId;
 }
-function getActiveProjectId() {
+function getActiveProjectId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.projectId) {
+    return localConfig.projectId;
+  }
   return loadConfig().activeProjectId;
 }
 function isConfigured() {
@@ -26634,19 +26687,36 @@ You can now use the MCP server with Claude Code.`);
   }
 });
 program.command("status").description("Show configuration status").action(() => {
-  const config2 = loadConfig();
+  const globalConfig2 = loadConfig();
+  const localConfig = loadLocalConfig();
+  const hasLocal = hasLocalConfig();
   if (isConfigured()) {
     console.log("Status: Configured");
-    console.log(`API Key: ${config2.apiKey?.slice(0, 8)}...`);
-    console.log(`API URL: ${config2.apiUrl}`);
-    if (config2.activeWorkspaceId) {
-      console.log(`Active Workspace: ${config2.activeWorkspaceId}`);
-    }
-    if (config2.activeProjectId) {
-      console.log(`Active Project: ${config2.activeProjectId}`);
+    console.log(`API Key: ${globalConfig2.apiKey?.slice(0, 8)}...`);
+    console.log(`API URL: ${globalConfig2.apiUrl}`);
+    console.log(`
+Global Context:`);
+    console.log(`  Workspace: ${globalConfig2.activeWorkspaceId || "(not set)"}`);
+    console.log(`  Project: ${globalConfig2.activeProjectId || "(not set)"}`);
+    if (hasLocal) {
+      console.log(`
+Local Context (${getLocalConfigPath()}):`);
+      console.log(`  Workspace: ${localConfig?.workspaceId || "(not set)"}`);
+      console.log(`  Project: ${localConfig?.projectId || "(not set)"}`);
     }
+    const effectiveWorkspace = getActiveWorkspaceId();
+    const effectiveProject = getActiveProjectId();
     console.log(`
-Config file: ${getConfigPath()}`);
+Active (effective):`);
+    const wsSource = localConfig?.workspaceId ? "local" : globalConfig2.activeWorkspaceId ? "global" : "";
+    const projSource = localConfig?.projectId ? "local" : globalConfig2.activeProjectId ? "global" : "";
+    console.log(`  Workspace: ${effectiveWorkspace || "(not set)"}${wsSource ? `  ← ${wsSource}` : ""}`);
+    console.log(`  Project: ${effectiveProject || "(not set)"}${projSource ? `  ← ${projSource}` : ""}`);
+    console.log(`
+Global config: ${getConfigPath()}`);
+    if (hasLocal) {
+      console.log(`Local config: ${getLocalConfigPath()}`);
+    }
   } else {
     console.log("Status: Not configured");
     console.log(`
@@ -26662,15 +26732,27 @@ program.command("reset").description("Remove stored configuration").action(() =>
   });
   console.log("Configuration reset successfully");
 });
-program.command("set-workspace <workspaceId>").description("Set the active workspace context").action((workspaceId) => {
-  setActiveWorkspace(workspaceId);
-  console.log(`Active workspace set to: ${workspaceId}`);
+program.command("set-workspace <workspaceId>").description("Set the active workspace context").option("-l, --local", "Save to local project config (.harmony-mcp.json) instead of global").action((workspaceId, options) => {
+  const isLocal = options.local;
+  setActiveWorkspace(workspaceId, { local: isLocal });
+  if (isLocal) {
+    console.log(`Local workspace set to: ${workspaceId}`);
+    console.log(`Config file: ${getLocalConfigPath()}`);
+  } else {
+    console.log(`Global workspace set to: ${workspaceId}`);
+  }
 });
-program.command("set-project <projectId>").description("Set the active project context").action((projectId) => {
-  setActiveProject(projectId);
-  console.log(`Active project set to: ${projectId}`);
+program.command("set-project <projectId>").description("Set the active project context").option("-l, --local", "Save to local project config (.harmony-mcp.json) instead of global").action((projectId, options) => {
+  const isLocal = options.local;
+  setActiveProject(projectId, { local: isLocal });
+  if (isLocal) {
+    console.log(`Local project set to: ${projectId}`);
+    console.log(`Config file: ${getLocalConfigPath()}`);
+  } else {
+    console.log(`Global project set to: ${projectId}`);
+  }
 });
-program.command("init").description("Initialize Harmony MCP for AI coding agents (Claude Code, Codex, Cursor, Windsurf)").option("-a, --agent <agents...>", `Agent(s) to configure: ${SUPPORTED_AGENTS.join(", ")}`).option("--all", "Configure all supported agents").option("--detect", "Auto-detect installed agents and configure them").option("-f, --force", "Overwrite existing configuration files").option("-d, --directory <path>", "Project directory (default: current directory)").action(async (options) => {
+program.command("init").description("Initialize Harmony MCP for AI coding agents (Claude Code, Codex, Cursor, Windsurf)").option("-a, --agent <agents...>", `Agent(s) to configure: ${SUPPORTED_AGENTS.join(", ")}`).option("--all", "Configure all supported agents").option("--detect", "Auto-detect installed agents and configure them").option("-f, --force", "Overwrite existing configuration files").option("-d, --directory <path>", "Project directory (default: current directory)").option("-w, --workspace <id>", "Set local workspace context for this project").option("-p, --project <id>", "Set local project context for this project").action(async (options) => {
   console.log(`Harmony MCP Initialization
 `);
   let agents = [];
@@ -26768,6 +26850,19 @@ ${result.agent.toUpperCase()}:`);
       console.log("  No changes made");
     }
   }
+  if (options.workspace || options.project) {
+    console.log(`
+LOCAL CONTEXT:`);
+    if (options.workspace) {
+      saveLocalConfig({ workspaceId: options.workspace }, cwd);
+      console.log(`  ✓ Workspace: ${options.workspace}`);
+    }
+    if (options.project) {
+      saveLocalConfig({ projectId: options.project }, cwd);
+      console.log(`  ✓ Project: ${options.project}`);
+    }
+    console.log(`  Config file: ${getLocalConfigPath(cwd)}`);
+  }
   console.log(`
 ` + "─".repeat(60));
   if (!isConfigured()) {

package/dist/index.js

@@ -22996,12 +22996,16 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 var DEFAULT_API_URL = "https://gethmy.com/api";
+var LOCAL_CONFIG_FILENAME = ".harmony-mcp.json";
 function getConfigDir() {
   return join(homedir(), ".harmony-mcp");
 }
 function getConfigPath() {
   return join(getConfigDir(), "config.json");
 }
+function getLocalConfigPath(cwd) {
+  return join(cwd || process.cwd(), LOCAL_CONFIG_FILENAME);
+}
 function loadConfig() {
   const configPath = getConfigPath();
   if (!existsSync(configPath)) {
@@ -23040,6 +23044,39 @@ function saveConfig(config2) {
   const newConfig = { ...existingConfig, ...config2 };
   writeFileSync(configPath, JSON.stringify(newConfig, null, 2), { mode: 384 });
 }
+function loadLocalConfig(cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  if (!existsSync(localConfigPath)) {
+    return null;
+  }
+  try {
+    const data = readFileSync(localConfigPath, "utf-8");
+    const config2 = JSON.parse(data);
+    return {
+      workspaceId: config2.workspaceId || null,
+      projectId: config2.projectId || null
+    };
+  } catch {
+    return null;
+  }
+}
+function saveLocalConfig(config2, cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  const existingConfig = loadLocalConfig(cwd) || {
+    workspaceId: null,
+    projectId: null
+  };
+  const newConfig = { ...existingConfig, ...config2 };
+  const cleanConfig = {};
+  if (newConfig.workspaceId)
+    cleanConfig.workspaceId = newConfig.workspaceId;
+  if (newConfig.projectId)
+    cleanConfig.projectId = newConfig.projectId;
+  writeFileSync(localConfigPath, JSON.stringify(cleanConfig, null, 2));
+}
+function hasLocalConfig(cwd) {
+  return existsSync(getLocalConfigPath(cwd));
+}
 function getApiKey() {
   const config2 = loadConfig();
   if (!config2.apiKey) {
@@ -23052,16 +23089,32 @@ function getApiUrl() {
   const config2 = loadConfig();
   return config2.apiUrl;
 }
-function setActiveWorkspace(workspaceId) {
-  saveConfig({ activeWorkspaceId: workspaceId });
+function setActiveWorkspace(workspaceId, options) {
+  if (options?.local) {
+    saveLocalConfig({ workspaceId }, options.cwd);
+  } else {
+    saveConfig({ activeWorkspaceId: workspaceId });
+  }
 }
-function setActiveProject(projectId) {
-  saveConfig({ activeProjectId: projectId });
+function setActiveProject(projectId, options) {
+  if (options?.local) {
+    saveLocalConfig({ projectId }, options.cwd);
+  } else {
+    saveConfig({ activeProjectId: projectId });
+  }
 }
-function getActiveWorkspaceId() {
+function getActiveWorkspaceId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.workspaceId) {
+    return localConfig.workspaceId;
+  }
   return loadConfig().activeWorkspaceId;
 }
-function getActiveProjectId() {
+function getActiveProjectId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.projectId) {
+    return localConfig.projectId;
+  }
   return loadConfig().activeProjectId;
 }
 function isConfigured() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",