npm - harmony-mcp - Versions diffs - 1.5.1 → 1.5.2 - Mend

harmony-mcp 1.5.1 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

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