open-index/open-npm huggingface dataset:
npm package: @gethmy/agent
Description: Push-based agent daemon for Harmony — watches board assignments and spawns Claude CLI workers
Latest version: 1.0.9

# @gethmy/agent

Push-based agent daemon for [Harmony](https://gethmy.com). Watches board assignments via Supabase Realtime and autonomously implements and reviews cards using Claude CLI workers in isolated git worktrees.

## Prerequisites

- [Node.js](https://nodejs.org) >= 20 or [Bun](https://bun.sh) >= 1.0
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed
- Git
- A [Harmony](https://gethmy.com) account with an API key
- [@gethmy/mcp](https://www.npmjs.com/package/@gethmy/mcp) configured (`npx @gethmy/mcp setup`)

## Installation

```bash
# 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:

```bash
npx @gethmy/mcp setup
```

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

```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:

```bash
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)