@kilogent/runner-dev 0.1.4 → 0.1.6
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.
- package/README.md +30 -4
- package/dist/cli.js +1360 -516
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -31,7 +31,7 @@ each publishes only a `latest` tag, and a machine changes environment by install
|
|
|
31
31
|
| | |
|
|
32
32
|
|---|---|
|
|
33
33
|
| **Node.js** | 20 or newer |
|
|
34
|
-
| **An engine CLI** | the
|
|
34
|
+
| **An engine CLI** | fetched for you — the daemon installs what your crews need (a few hundred MB each). Bring your own with `CREW_<ENGINE>_BIN`, or decline the lot with `config set autoInstallEngines off`. See [Engines](#engines). |
|
|
35
35
|
| **git / gh** | only if your agents work on GitHub repositories |
|
|
36
36
|
| **A Lumi Crew account** | with at least one Ship — [app.kilogent.com](https://app.kilogent.com) |
|
|
37
37
|
|
|
@@ -43,13 +43,39 @@ against your Ship membership. No service-account key ever touches your machine.
|
|
|
43
43
|
An agent runs on an **engine** — the CLI that actually holds the session. The daemon spawns the
|
|
44
44
|
engine's binary per job, and `doctor` checks that every engine a Ship's agents use is installed.
|
|
45
45
|
|
|
46
|
+
**You do not have to install them yourself.** The daemon fetches the CLIs its crews need into its
|
|
47
|
+
own folder (`~/.kilogent-runner/tools/<engine>/`) and runs agents on that copy. A CLI you installed
|
|
48
|
+
yourself is never changed or removed, and the two stay independent: upgrade yours whenever you like,
|
|
49
|
+
the crew keeps running on the version the fleet knows works.
|
|
50
|
+
|
|
51
|
+
⚠️ **They are large.** The Codex CLI is about 284 MB installed and Claude Code about 202 MB. Each is
|
|
52
|
+
replaced rather than added to on an upgrade, so a machine running both settles around half a
|
|
53
|
+
gigabyte. To decline the whole thing and manage them yourself:
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
kilogent-runner config set autoInstallEngines off
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Which version a machine installs comes from the fleet, not from this machine: it takes the version
|
|
60
|
+
known to work, moves to a newer release only after that release has been out for a day, and never
|
|
61
|
+
installs one another machine has proved broken. If a new version breaks a job here, this daemon puts
|
|
62
|
+
the working version back, runs the job again, and — only if that succeeds — tells the fleet, so no
|
|
63
|
+
other machine installs it.
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
kilogent-runner engine list what each engine needs, what this machine has, and where it came from
|
|
67
|
+
kilogent-runner engine install [engine...] install now (--check, --dry-run, --force)
|
|
68
|
+
kilogent-runner engine uninstall <engine> remove this runner's copy, never yours
|
|
69
|
+
```
|
|
70
|
+
|
|
46
71
|
| Engine | Binary | Credential |
|
|
47
72
|
|---|---|---|
|
|
48
73
|
| Claude Code | `claude` ([install](https://claude.com/claude-code)) | a `claude setup-token`, pasted once per Ship in the Crew app |
|
|
49
74
|
| Codex CLI | `codex` ([install](https://developers.openai.com/codex)) | a **machine sign-in**: a captain picks this machine in the Crew app, the daemon runs `codex login --device-auth`, and the captain approves the code on a phone. The login stays on this machine — see [Credentials](#credentials). |
|
|
50
75
|
|
|
51
|
-
Each engine's binary can be overridden with `CREW_<ENGINE>_BIN` (`CREW_CLAUDE_BIN`), which
|
|
52
|
-
|
|
76
|
+
Each engine's binary can be overridden with `CREW_<ENGINE>_BIN` (`CREW_CLAUDE_BIN`), which wins over
|
|
77
|
+
the copy the daemon installed and is the supported way to pin a machine to a particular binary. It
|
|
78
|
+
is also how the test suites substitute a deterministic fake.
|
|
53
79
|
|
|
54
80
|
## Connect a machine
|
|
55
81
|
|
|
@@ -330,7 +356,7 @@ claiming from one queue.
|
|
|
330
356
|
| Var | Effect |
|
|
331
357
|
|---|---|
|
|
332
358
|
| `LUMI_RUNNER_HOME` | Config + log directory (default `~/.kilogent-runner`) |
|
|
333
|
-
| `CREW_<ENGINE>_BIN` | Path to an engine's binary, e.g. `CREW_CLAUDE_BIN`, `CREW_CODEX_BIN` (default: the engine's own name from `PATH`) |
|
|
359
|
+
| `CREW_<ENGINE>_BIN` | Path to an engine's binary, e.g. `CREW_CLAUDE_BIN`, `CREW_CODEX_BIN` (default: the copy this runner installed, else the engine's own name from `PATH`) |
|
|
334
360
|
| `CREW_MACHINE_LOGIN_TIMEOUT_MS` | How long a machine sign-in may wait for approval before it is reported expired (default: 16 minutes; a test seam) |
|
|
335
361
|
| `CREW_NO_NOTIFY` | Force desktop notifications off, whatever the config says (they are off by default) |
|
|
336
362
|
| `CREW_NO_POWER` | Disable sleep inhibition |
|