@gethmy/agent 1.0.0

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
  1. package/README.md +66 -0
  2. package/dist/cli.js +11761 -0
  3. package/dist/index.js +11760 -0
  4. package/package.json +52 -0
package/README.md ADDED
@@ -0,0 +1,66 @@
1
+ # @gethmy/agent
2
+
3
+ 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.
4
+
5
+ ## Prerequisites
6
+
7
+ - [Bun](https://bun.sh) >= 1.0.0
8
+ - [Claude CLI](https://docs.anthropic.com/en/docs/claude-code)
9
+ - Git
10
+ - A [Harmony](https://gethmy.com) account with an API key
11
+
12
+ ## Installation
13
+
14
+ ```bash
15
+ # Run directly
16
+ bunx @gethmy/agent
17
+
18
+ # Or install globally
19
+ bun install -g @gethmy/agent
20
+ harmony-agent
21
+ ```
22
+
23
+ ## Configuration
24
+
25
+ 1. Set up the MCP server first:
26
+
27
+ ```bash
28
+ npx @gethmy/mcp setup
29
+ ```
30
+
31
+ 2. Add agent config to `~/.harmony-mcp/config.json`:
32
+
33
+ ```json
34
+ {
35
+ "agent": {
36
+ "poolSize": 1,
37
+ "pickupColumns": ["To Do"],
38
+ "claude": {
39
+ "model": "sonnet"
40
+ },
41
+ "review": {
42
+ "enabled": true,
43
+ "pickupColumns": ["Review"],
44
+ "moveToColumn": "Done",
45
+ "failColumn": "To Do"
46
+ }
47
+ }
48
+ }
49
+ ```
50
+
51
+ ## Usage
52
+
53
+ Run from your git repository root:
54
+
55
+ ```bash
56
+ harmony-agent
57
+ ```
58
+
59
+ The daemon will:
60
+
61
+ 1. Watch for cards assigned to your agent user
62
+ 2. Pick up cards from configured columns
63
+ 3. Implement changes in isolated git worktrees
64
+ 4. Verify builds pass (build + lint)
65
+ 5. Push branches and move cards to Review
66
+ 6. Review cards and approve (create PR) or reject (move back to To Do)