harmony-mcp 1.5.1 → 1.5.3

package/README.md

@@ -1,6 +1,7 @@
 # harmony-mcp
 
-MCP (Model Context Protocol) server for Harmony Kanban board. Enables AI coding agents (Claude Code, OpenAI Codex, Cursor, Windsurf) to interact with your Harmony boards.
+MCP (Model Context Protocol) server for [Harmony](https://gethmy.com).
+Enables AI coding agents (Claude Code, OpenAI Codex, Cursor, Windsurf) to interact with your Harmony boards.
 
 ## Features
 
@@ -19,7 +20,7 @@ MCP (Model Context Protocol) server for Harmony Kanban board. Enables AI coding
 ### 1. Get an API Key
 
 1. Log into [Harmony](https://gethmy.com)
-2. Go to **Settings → API Keys**
+2. Go to **[API Keys](https://gethmy.com/user/keys)**
 3. Click **"Generate New Key"**
 4. Copy the key (starts with `hmy_`)
 
@@ -30,6 +31,7 @@ npx harmony-mcp setup
 ```
 
 The smart setup wizard will:
+
 - Validate your API key
 - Detect installed AI agents (Claude Code, Cursor, Windsurf, Codex)
 - Install skills globally (recommended) or locally
@@ -67,26 +69,26 @@ npx harmony-mcp serve              # Start MCP server
 
 ### Setup Options
 
-| Flag | Description |
-|------|-------------|
-| `-k, --api-key <key>` | API key (skips prompt) |
-| `-e, --email <email>` | Your email for auto-assignment |
+| Flag                       | Description                                          |
+| -------------------------- | ---------------------------------------------------- |
+| `-k, --api-key <key>`      | API key (skips prompt)                               |
+| `-e, --email <email>`      | Your email for auto-assignment                       |
 | `-a, --agents <agents...>` | Agents to configure: claude, codex, cursor, windsurf |
-| `-g, --global` | Install skills globally (recommended) |
-| `-l, --local` | Install skills locally in project directory |
-| `-w, --workspace <id>` | Set workspace context |
-| `-p, --project <id>` | Set project context |
-| `--skip-context` | Skip workspace/project selection |
-| `-f, --force` | Overwrite existing configuration |
+| `-g, --global`             | Install skills globally (recommended)                |
+| `-l, --local`              | Install skills locally in project directory          |
+| `-w, --workspace <id>`     | Set workspace context                                |
+| `-p, --project <id>`       | Set project context                                  |
+| `--skip-context`           | Skip workspace/project selection                     |
+| `-f, --force`              | Overwrite existing configuration                     |
 
 ## Supported AI Agents
 
-| Agent | Workflow Command | Config Location |
-|-------|------------------|-----------------|
-| **Claude Code** | `/hmy #42` | `~/.claude/settings.json` |
-| **OpenAI Codex** | `/prompts:hmy #42` | `~/.codex/config.toml` |
-| **Cursor** | MCP tools auto-available | `.cursor/mcp.json` |
-| **Windsurf** | MCP tools auto-available | `~/.codeium/windsurf/mcp_config.json` |
+| Agent            | Workflow Command         | Config Location                       |
+| ---------------- | ------------------------ | ------------------------------------- |
+| **Claude Code**  | `/hmy #42`               | `~/.claude/settings.json`             |
+| **OpenAI Codex** | `/prompts:hmy #42`       | `~/.codex/config.toml`                |
+| **Cursor**       | MCP tools auto-available | `.cursor/mcp.json`                    |
+| **Windsurf**     | MCP tools auto-available | `~/.codeium/windsurf/mcp_config.json` |
 
 ## Card Workflow
 
@@ -182,6 +184,7 @@ When you start working on a card (e.g., `/hmy #42`):
 | `customConstraints` | Additional instructions to append |
 
 **Variants:**
+
 - `analysis` - Understand the problem and create a plan
 - `draft` - Design a solution approach
 - `execute` - Full implementation (default)
@@ -199,32 +202,32 @@ curl -X GET "https://gethmy.com/api/v1/workspaces" \
 
 ### API Endpoints
 
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/v1/workspaces` | GET | List workspaces |
-| `/v1/workspaces/:id/projects` | GET | List projects in workspace |
-| `/v1/workspaces/:id/members` | GET | Get workspace members |
-| `/v1/board/:projectId` | GET | Get full board state |
-| `/v1/cards` | POST | Create card |
-| `/v1/cards/:id` | GET | Get card |
-| `/v1/cards/:id` | PATCH | Update card |
-| `/v1/cards/:id` | DELETE | Delete card |
-| `/v1/cards/:id/move` | POST | Move card |
-| `/v1/search?q=query` | GET | Search cards |
-| `/v1/columns` | POST | Create column |
-| `/v1/columns/:id` | PATCH | Update column |
-| `/v1/columns/:id` | DELETE | Delete column |
-| `/v1/labels` | POST | Create label |
-| `/v1/cards/:id/labels` | POST | Add label to card |
-| `/v1/cards/:id/labels/:labelId` | DELETE | Remove label |
-| `/v1/subtasks` | POST | Create subtask |
-| `/v1/subtasks/:id/toggle` | POST | Toggle subtask |
-| `/v1/subtasks/:id` | DELETE | Delete subtask |
-| `/v1/cards/:id/links` | GET | Get card links |
-| `/v1/cards/:id/links` | POST | Create card link |
-| `/v1/links/:id` | DELETE | Delete card link |
-| `/v1/cards/:id/prompt` | GET | Generate prompt from card |
-| `/v1/nlu` | POST | Process natural language |
+| Endpoint                        | Method | Description                |
+| ------------------------------- | ------ | -------------------------- |
+| `/v1/workspaces`                | GET    | List workspaces            |
+| `/v1/workspaces/:id/projects`   | GET    | List projects in workspace |
+| `/v1/workspaces/:id/members`    | GET    | Get workspace members      |
+| `/v1/board/:projectId`          | GET    | Get full board state       |
+| `/v1/cards`                     | POST   | Create card                |
+| `/v1/cards/:id`                 | GET    | Get card                   |
+| `/v1/cards/:id`                 | PATCH  | Update card                |
+| `/v1/cards/:id`                 | DELETE | Delete card                |
+| `/v1/cards/:id/move`            | POST   | Move card                  |
+| `/v1/search?q=query`            | GET    | Search cards               |
+| `/v1/columns`                   | POST   | Create column              |
+| `/v1/columns/:id`               | PATCH  | Update column              |
+| `/v1/columns/:id`               | DELETE | Delete column              |
+| `/v1/labels`                    | POST   | Create label               |
+| `/v1/cards/:id/labels`          | POST   | Add label to card          |
+| `/v1/cards/:id/labels/:labelId` | DELETE | Remove label               |
+| `/v1/subtasks`                  | POST   | Create subtask             |
+| `/v1/subtasks/:id/toggle`       | POST   | Toggle subtask             |
+| `/v1/subtasks/:id`              | DELETE | Delete subtask             |
+| `/v1/cards/:id/links`           | GET    | Get card links             |
+| `/v1/cards/:id/links`           | POST   | Create card link           |
+| `/v1/links/:id`                 | DELETE | Delete card link           |
+| `/v1/cards/:id/prompt`          | GET    | Generate prompt from card  |
+| `/v1/nlu`                       | POST   | Process natural language   |
 
 ## Configuration
 
@@ -262,6 +265,7 @@ Stored in `.harmony-mcp.json` in your project root:
 When your email is configured during setup, cards are automatically assigned to you when you start an agent session (e.g., via `/hmy #42`). This helps track who is working on what.
 
 To update your email:
+
 ```bash
 npx harmony-mcp setup --email you@example.com
 ```

package/dist/cli.js

@@ -29478,24 +29478,24 @@ function areSkillsInstalled(cwd) {
     foundPaths.push(globalSkillPath);
     return { installed: true, location: "global", paths: foundPaths };
   }
-  const claudeGlobalCommand = join(home, ".claude", "commands", "hmy.md");
-  if (existsSync(claudeGlobalCommand)) {
-    foundPaths.push(claudeGlobalCommand);
-    return { installed: true, location: "global", paths: foundPaths };
-  }
-  const claudeGlobalSkill = join(home, ".claude", "skills", "hmy", "SKILL.md");
+  const claudeGlobalSkill = join(home, ".claude", "skills", "hmy.md");
   if (existsSync(claudeGlobalSkill)) {
     foundPaths.push(claudeGlobalSkill);
     return { installed: true, location: "global", paths: foundPaths };
   }
-  const localSkillPath = join(workingDir, ".claude", "skills", "hmy", "SKILL.md");
+  const claudeGlobalSkillAlt = join(home, ".claude", "skills", "hmy", "SKILL.md");
+  if (existsSync(claudeGlobalSkillAlt)) {
+    foundPaths.push(claudeGlobalSkillAlt);
+    return { installed: true, location: "global", paths: foundPaths };
+  }
+  const localSkillPath = join(workingDir, ".claude", "skills", "hmy.md");
   if (existsSync(localSkillPath)) {
     foundPaths.push(localSkillPath);
     return { installed: true, location: "local", paths: foundPaths };
   }
-  const localCommandPath = join(workingDir, ".claude", "commands", "hmy.md");
-  if (existsSync(localCommandPath)) {
-    foundPaths.push(localCommandPath);
+  const localSkillPathAlt = join(workingDir, ".claude", "skills", "hmy", "SKILL.md");
+  if (existsSync(localSkillPathAlt)) {
+    foundPaths.push(localSkillPathAlt);
     return { installed: true, location: "local", paths: foundPaths };
   }
   return { installed: false, location: null, paths: [] };
@@ -31864,8 +31864,9 @@ function getAgentFiles(agentId, cwd, installMode = "global") {
   const symlinks = [];
   switch (agentId) {
     case "claude": {
-      const commandContent = `---
-description: Start working on a Harmony card (moves to In Progress, adds agent label)
+      const skillContent = `---
+name: hmy
+description: Start working on a Harmony card. Use when given a card reference like #42, UUID, or card name to implement.
 argument-hint: <card-reference>
 ---
 
@@ -31873,18 +31874,18 @@ ${HARMONY_WORKFLOW_PROMPT.replace("Your agent identifier", "claude-code").replac
 `;
       if (installMode === "global") {
         files.push({
-          path: join3(GLOBAL_SKILLS_DIR, "claude", "hmy.md"),
-          content: commandContent,
+          path: join3(GLOBAL_SKILLS_DIR, "hmy", "SKILL.md"),
+          content: skillContent,
           type: "text"
         });
         symlinks.push({
-          target: join3(GLOBAL_SKILLS_DIR, "claude", "hmy.md"),
-          link: join3(home, ".claude", "commands", "hmy.md")
+          target: join3(GLOBAL_SKILLS_DIR, "hmy"),
+          link: join3(home, ".claude", "skills", "hmy")
         });
       } else {
         files.push({
-          path: join3(cwd, ".claude", "commands", "hmy.md"),
-          content: commandContent,
+          path: join3(cwd, ".claude", "skills", "hmy", "SKILL.md"),
+          content: skillContent,
           type: "text"
         });
       }

package/dist/index.js

@@ -27241,24 +27241,24 @@ function areSkillsInstalled(cwd) {
     foundPaths.push(globalSkillPath);
     return { installed: true, location: "global", paths: foundPaths };
   }
-  const claudeGlobalCommand = join(home, ".claude", "commands", "hmy.md");
-  if (existsSync(claudeGlobalCommand)) {
-    foundPaths.push(claudeGlobalCommand);
-    return { installed: true, location: "global", paths: foundPaths };
-  }
-  const claudeGlobalSkill = join(home, ".claude", "skills", "hmy", "SKILL.md");
+  const claudeGlobalSkill = join(home, ".claude", "skills", "hmy.md");
   if (existsSync(claudeGlobalSkill)) {
     foundPaths.push(claudeGlobalSkill);
     return { installed: true, location: "global", paths: foundPaths };
   }
-  const localSkillPath = join(workingDir, ".claude", "skills", "hmy", "SKILL.md");
+  const claudeGlobalSkillAlt = join(home, ".claude", "skills", "hmy", "SKILL.md");
+  if (existsSync(claudeGlobalSkillAlt)) {
+    foundPaths.push(claudeGlobalSkillAlt);
+    return { installed: true, location: "global", paths: foundPaths };
+  }
+  const localSkillPath = join(workingDir, ".claude", "skills", "hmy.md");
   if (existsSync(localSkillPath)) {
     foundPaths.push(localSkillPath);
     return { installed: true, location: "local", paths: foundPaths };
   }
-  const localCommandPath = join(workingDir, ".claude", "commands", "hmy.md");
-  if (existsSync(localCommandPath)) {
-    foundPaths.push(localCommandPath);
+  const localSkillPathAlt = join(workingDir, ".claude", "skills", "hmy", "SKILL.md");
+  if (existsSync(localSkillPathAlt)) {
+    foundPaths.push(localSkillPathAlt);
     return { installed: true, location: "local", paths: foundPaths };
   }
   return { installed: false, location: null, paths: [] };

package/package.json

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