@gethmy/agent 1.35.0 → 1.37.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 +9 -4
  2. package/dist/cli.js +1545 -830
  3. package/dist/index.js +1150 -812
  4. package/package.json +3 -3
package/README.md CHANGED
@@ -38,7 +38,7 @@ harmony-agent
38
38
  npx @gethmy/mcp setup
39
39
  ```
40
40
 
41
- 2. Add agent config to `~/.harmony-mcp/config.json`. Every field is optional — the snippet below shows the common options with their defaults. For the full schema (worktree, verification, completion, priority labels), see [docs/agent-daemon.md](../../docs/agent-daemon.md):
41
+ 2. Add agent config to `~/.hmy/agent/config.json`. Every field is optional — the snippet below shows the common options with their defaults. For the full schema (worktree, verification, completion, priority labels), see [docs/agent-daemon.md](../../docs/agent-daemon.md):
42
42
 
43
43
  ```jsonc
44
44
  {
@@ -68,7 +68,12 @@ npx @gethmy/mcp setup
68
68
  "http": {
69
69
  "enabled": true,
70
70
  "port": 47821,
71
- "bindAddr": "127.0.0.1"
71
+ "bindAddr": "127.0.0.1" // LOOPBACK ONLY. The control server is
72
+ // unauthenticated, so this is its whole
73
+ // access control — POST /sweep/stop is the
74
+ // kill switch. 0.0.0.0, "" or a LAN address
75
+ // refuse the daemon at startup (#1061);
76
+ // tunnel to loopback for remote access.
72
77
  },
73
78
  "timing": {
74
79
  "heartbeatMs": 30000,
@@ -123,13 +128,13 @@ harmony-agent help # Show usage
123
128
 
124
129
  ## State
125
130
 
126
- Durable state lives at `~/.harmony-mcp/state/<projectId>.json` — one file per project, so two daemons on one machine never read or write each other's runs (#1057). Tracks live runs, per-card attempts and costs, daily spend, and DLQ markers. Atomic writes via write-to-tmp + rename. On the first start after upgrading, the daemon splits its own records out of the old machine-global `~/.harmony-mcp/agent-state.json` (a `.pre-scope-backup` copy is kept). The split is gated on its own `<projectId>.json.migrated` marker, so a failed or skipped attempt retries on the next start; a card record no worktree can attribute is copied into every project file rather than dropped.
131
+ Durable state lives at `~/.hmy/agent/state/<projectId>.json` — one file per project, so two daemons on one machine never read or write each other's runs (#1057). Tracks live runs, per-card attempts and costs, daily spend, and DLQ markers. Atomic writes via write-to-tmp + rename. On the first start after upgrading, the daemon splits its own records out of the old machine-global `~/.hmy/agent/agent-state.json` (a `.pre-scope-backup` copy is kept). The split is gated on its own `<projectId>.json.migrated` marker, so a failed or skipped attempt retries on the next start; a card record no worktree can attribute is copied into every project file rather than dropped.
127
132
 
128
133
  Worktrees live at `.harmony-worktrees/` inside your repo. A background sweep every 5 minutes removes directories older than 1 hour that no live run claims.
129
134
 
130
135
  ## Debugging
131
136
 
132
- Every Claude CLI run writes a per-run log at `~/.harmony-mcp/runs/<runId>-card-<shortId>.log` — full stdout (NDJSON), stderr, parse errors, and an exit footer with tool-call and cost totals. Start there when a run ends silently or the card activity log shows only "Still working..." heartbeats.
137
+ Every Claude CLI run writes a per-run log at `~/.hmy/agent/runs/<runId>-card-<shortId>.log` — full stdout (NDJSON), stderr, parse errors, and an exit footer with tool-call and cost totals. Start there when a run ends silently or the card activity log shows only "Still working..." heartbeats.
133
138
 
134
139
  See [Debugging a Silent Run](../../docs/agent-daemon.md#debugging-a-silent-run) for interpretation table and retention notes.
135
140