Package Exports

@gethmy/agent
@gethmy/agent/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@gethmy/agent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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

Set up the MCP server first:

npx @gethmy/mcp setup

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:

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