@gethmy/agent 1.44.0 → 1.46.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 +19 -14
  2. package/dist/cli.js +535 -158
  3. package/dist/index.js +479 -141
  4. package/package.json +3 -3
package/README.md CHANGED
@@ -10,32 +10,37 @@ Built for **failsafe auto mode**: crashed daemons recover on restart, misconfigu
10
10
  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed
11
11
  - Git
12
12
  - A [Harmony](https://gethmy.com) account with an API key
13
- - [@gethmy/mcp](https://www.npmjs.com/package/@gethmy/mcp) configured (`npx @gethmy/mcp setup`)
13
+ - The repository connected (`hmy connect`, or `npx @gethmy/mcp connect` with nothing installed)
14
14
 
15
15
  ## Installation
16
16
 
17
17
  ```bash
18
- # Run directly (works with any package manager)
19
- npx @gethmy/agent@latest
18
+ # The front door — one install carries this package too
19
+ npm i -g @gethmy/cli
20
+ hmy agent
20
21
 
21
- # Or install globally
22
- npm install -g @gethmy/agent
23
- harmony-agent
22
+ # Or nothing installed at all (works with any package manager)
23
+ npx @gethmy/agent@latest
24
24
  ```
25
25
 
26
- > **Always pin `@latest`.** A bare `npx @gethmy/agent` reuses any previously
27
- > cached version that satisfies the spec — so an old install in `~/.npm/_npx`
28
- > can shadow the current release and you'll get stale startup logs and CLI
29
- > behavior. `npx @gethmy/agent@latest` re-resolves to the newest published
30
- > version. If you ever suspect a stale run, clear the cache with
31
- > `rm -rf ~/.npm/_npx` (or install globally to skip npx caching entirely).
26
+ Install when the machine is yours; use `npx` for a container, a CI step or a
27
+ one-off. Both forms stay supported.
28
+
29
+ > **`npx` can serve a stale build.** The npx cache keeps serving the version it
30
+ > first installed, `@latest` included — a restart six minutes after 1.38.0
31
+ > published still ran 1.37.0 — so you get stale startup logs and CLI behavior.
32
+ > If you suspect a stale run, clear the cache with `rm -rf ~/.npm/_npx`, or
33
+ > install `@gethmy/cli` and run `hmy agent` to skip npx caching entirely.
32
34
 
33
35
  ## Configuration
34
36
 
35
- 1. Set up the MCP server first:
37
+ 1. Connect the repository first:
36
38
 
37
39
  ```bash
38
- npx @gethmy/mcp setup
40
+ hmy connect
41
+
42
+ # nothing installed? same command, no install:
43
+ npx @gethmy/mcp connect
39
44
  ```
40
45
 
41
46
  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):