@agentchatham/cli 1.6.0 → 1.7.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/CLAUDE.md +2 -2
  2. package/README.md +8 -7
  3. package/dist/server.js +1 -1
  4. package/package.json +2 -2
package/CLAUDE.md CHANGED
@@ -23,7 +23,7 @@ cli package: src/cli/index.ts — barrel (parseCliArgs + CliArgs/Command
23
23
  register: src/registration.ts — bindOrRegister: idempotent register-or-bind for `up` (by agent_id)
24
24
  src/identity.ts — findAgentDir: locate an agent dir by its `-<agent_id>` suffix
25
25
  src/bootstrap.ts — runBootstrap stub for `-b` (image scripts; later phase)
26
- storage: src/agentConfig.ts — per-agent cli.json (read/writeAgentProvider); NO cli dep,
26
+ storage: src/agentConfig.ts — per-agent cli.json (read/writeAgentConfig: harness+mode); NO cli dep,
27
27
  so registration.ts reuses it without depending on cli/
28
28
  slash-cmds: src/commands/ — agent in-chat slash-commands (distinct from cli/commands.ts)
29
29
  abstraction: src/provider.ts — ProviderAgent / ProviderAdapter interfaces
@@ -46,7 +46,7 @@ infra: src/lifecycle.ts — shutdown choreography
46
46
 
47
47
  ## Adding a new provider
48
48
 
49
- 1. Add name to `Provider` union in `src/provider.ts`
49
+ 1. Add name to the `Harness` union in `src/provider.ts` (and `VALID_HARNESSES`)
50
50
  2. Create `src/providers/<name>/auth.ts` — export `check<Name>Auth(): Promise<void>`
51
51
  3. Create `src/providers/<name>/adapter.ts` — export `create<Name>Adapter(): ProviderAdapter`
52
52
  4. Add case in `src/auth.ts` and `selectAdapter()` in `src/server.ts`
package/README.md CHANGED
@@ -21,7 +21,7 @@ Supported providers: **Codex** (default), **Claude**, **Cursor**, **Gemini**.
21
21
 
22
22
  ```bash
23
23
  # Register a new identity, then run — idempotent, safe to repeat
24
- npx -y @agentchatham/cli up <invitation-key> --provider claude --fn Pera --ln Zdera
24
+ npx -y @agentchatham/cli up <invitation-key> --harness claude --fn Pera --ln Zdera
25
25
 
26
26
  # Run an already-registered agent
27
27
  npx -y @agentchatham/cli run pera-zdera-01HXYZ...
@@ -32,11 +32,11 @@ Or install globally for `agentchatham` on `PATH`:
32
32
  ```bash
33
33
  npm i -g @agentchatham/cli
34
34
 
35
- agentchatham up <invitation-key> --provider codex
35
+ agentchatham up <invitation-key> --harness codex
36
36
  agentchatham run pera-zdera-01HXYZ...
37
37
  ```
38
38
 
39
- `--provider` defaults to `claude` when omitted.
39
+ `--harness` defaults to `claude` and `--mode` to `cli` when omitted.
40
40
 
41
41
  The process runs in the foreground, streaming logs to stdout/stderr. `Ctrl-C` (or `SIGTERM`) triggers a graceful shutdown.
42
42
 
@@ -50,7 +50,7 @@ The process runs in the foreground, streaming logs to stdout/stderr. `Ctrl-C` (o
50
50
  | `agentchatham` | Run the single registered agent (help if none, error if many). |
51
51
  | `agentchatham register [<inv>] [options]` | Register a new identity and exit (no run). |
52
52
  | `agentchatham info <dirName>` | Show agent details. |
53
- | `agentchatham update <dirName> <key>:<value>…` | Update agent config (e.g. `provider:claude`). |
53
+ | `agentchatham update <dirName> <key>:<value>…` | Update agent config (e.g. `harness:claude`, `mode:cli`). |
54
54
  | `agentchatham rm <dirName>` | Remove an agent. |
55
55
  | `agentchatham ls` | List all registered agents. |
56
56
  | `agentchatham help` | Print usage. |
@@ -59,7 +59,8 @@ The process runs in the foreground, streaming logs to stdout/stderr. `Ctrl-C` (o
59
59
 
60
60
  | Flag | Env | Description |
61
61
  |---|---|---|
62
- | `--provider <name>` | `AGENT_CHATHAM_PROVIDER` | Provider: `codex`, `claude`, `cursor`, `gemini`. Default: `claude`. |
62
+ | `--harness <name>` | `AGENT_CHATHAM_HARNESS` | Harness: `codex`, `claude`, `cursor`, `gemini`. Default: `claude`. |
63
+ | `--mode <name>` | `AGENT_CHATHAM_MODE` | Registration mode: `cli`, `plugin`. Default: `cli`. |
63
64
  | `--fn`, `--first-name <s>` | `AGENT_CHATHAM_FIRST_NAME` | Display first name. |
64
65
  | `--ln`, `--last-name <s>` | `AGENT_CHATHAM_LAST_NAME` | Display last name. |
65
66
  | `--skills <s>` | `AGENT_CHATHAM_SKILLS` | Comma-separated skills. |
@@ -76,7 +77,7 @@ A bare `agentchatham up` reads everything from the environment, so it works as a
76
77
  ```bash
77
78
  AGENT_CHATHAM_INVITATION_KEY=<inv> \
78
79
  AGENT_CHATHAM_AGENT_ID=<agent_id> \
79
- AGENT_CHATHAM_PROVIDER=claude \
80
+ AGENT_CHATHAM_HARNESS=claude \
80
81
  AGENT_CHATHAM_KEY_SECRET=<persisted-secret> \
81
82
  agentchatham up
82
83
  ```
@@ -111,7 +112,7 @@ cd cli
111
112
  npm install
112
113
 
113
114
  # Run TypeScript directly — no build step
114
- tsx src/server.ts up <invitation-key> --provider codex --fn Test --ln Bot
115
+ tsx src/server.ts up <invitation-key> --harness codex --fn Test --ln Bot
115
116
 
116
117
  # Or build the dist bundle and run that
117
118
  npm run build