@gethmy/agent

Push-based agent daemon for Harmony. Watches board assignments via Supabase Realtime and autonomously implements and reviews cards using Claude CLI workers in isolated git worktrees.

Prerequisites

• Node.js >= 20 or Bun >= 1.0
• Claude Code CLI installed
• Git
• A Harmony account with an API key
• @gethmy/mcp configured (npx @gethmy/mcp setup)

Installation

# Run directly (works with any package manager)
npx @gethmy/agent

# Or install globally
npm install -g @gethmy/agent
harmony-agent

Configuration

1. Set up the MCP server first:

npx @gethmy/mcp setup

2. Add agent config to ~/.harmony-mcp/config.json:

{
  "agent": {
    "poolSize": 1,
    "pickupColumns": ["To Do"],
    "claude": {
      "model": "sonnet"
    },
    "review": {
      "enabled": true,
      "pickupColumns": ["Review"],
      "moveToColumn": "Done",
      "failColumn": "To Do"
    }
  }
}

Usage

Run from your git repository root:

npx @gethmy/agent

The daemon will:

1. Watch for cards assigned to your agent user
2. Pick up cards from configured columns
3. Implement changes in isolated git worktrees
4. Verify builds pass (build + lint)
5. Push branches and move cards to Review
6. Review cards and approve (create PR) or reject (move back to To Do)