plangineer-runner 0.0.0-stage → 0.1.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.
- package/README.md +36 -2
- package/dist/cli.mjs +2977 -0
- package/package.json +34 -4
package/README.md
CHANGED
|
@@ -1,3 +1,37 @@
|
|
|
1
|
-
#
|
|
1
|
+
# plangineer-runner
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The Plangineer runner runs agent jobs from a Plangineer deployment on your machine, with the coding CLI you have installed and signed in to. It also keeps a repository's agent skills in sync between `.agents/skills/` and the `.claude/skills/` mirror.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
Node 24 is required.
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install --global plangineer-runner
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Commands
|
|
14
|
+
|
|
15
|
+
| Command | Does |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `plangineer-runner pair --server <url> --code <code> [--name <name>]` | Pairs this machine with a deployment, using a pairing code from its Runners screen. `--name` defaults to the machine's host name |
|
|
18
|
+
| `plangineer-runner start` | Connects to the deployment and runs the jobs it assigns until stopped |
|
|
19
|
+
| `plangineer-runner skills sync` | Writes the `.claude/skills/` mirror from `.agents/skills/` |
|
|
20
|
+
| `plangineer-runner skills check [--staged]` | Fails on any missing, changed or stray mirror file, writing nothing. `--staged` checks the git index |
|
|
21
|
+
| `plangineer-runner skills lint` | Checks each skill under `.agents/skills/` against the skill file rules |
|
|
22
|
+
| `plangineer-runner --version` | Prints the runner's version |
|
|
23
|
+
|
|
24
|
+
Edit skills only under `.agents/skills/`, then run `plangineer-runner skills sync`. In CI, `npx --yes plangineer-runner skills check` fails the build on a drifted mirror.
|
|
25
|
+
|
|
26
|
+
## Settings
|
|
27
|
+
|
|
28
|
+
The runner reads these optional variables from its environment.
|
|
29
|
+
|
|
30
|
+
| Variable | Default |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| `PLANGINEER_RUNNER_DATA_DIR` | The user data directory |
|
|
33
|
+
| `PLANGINEER_RUNNER_CONCURRENCY` | `2` |
|
|
34
|
+
| `PLANGINEER_CLAUDE_COMMAND` | `["claude"]` |
|
|
35
|
+
| `PLANGINEER_GIT_BASE_URL` | `https://github.com` |
|
|
36
|
+
| `PLANGINEER_RUN_TIMEOUT_MS` | `3600000` |
|
|
37
|
+
| `LOG_LEVEL` | `info` |
|