You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .agents/skills/pioreactor-cli/SKILL.md
+15-23Lines changed: 15 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,14 +38,6 @@ Prefer the command's current `--help` output and the implementation in `core/pio
38
38
- Test a job or command locally with `pio` before scaling it through `pios` when that is practical.
39
39
- Remember that `pios` adds target selectors such as `--units` and `--experiments`; avoid relying on the default target set unless the user explicitly asked for all eligible workers.
40
40
41
-
## Source Files
42
-
43
-
-`core/pioreactor/cli/pio.py`: local CLI command group and many subcommands.
-`core/pioreactor/cli/run.py`: `pio run` job discovery and launch behavior.
46
-
-`core/pioreactor/web/tasks.py`: Huey-backed tasks used by some leader/web workflows.
47
-
-`core/pioreactor/config.py`: config loading and override behavior.
48
-
49
41
## Safe Execution Rules
50
42
51
43
- Do not run broad production-affecting commands unless the user explicitly asked for that scope. Examples: `pios kill --all-jobs -y`, `pios shutdown`, `pios reboot`, `pios update app`, `pios rm`, and cluster-wide plugin changes.
@@ -59,29 +51,29 @@ Prefer the command's current `--help` output and the implementation in `core/pio
Check `core/pioreactor/background_jobs/base.py` and the job implementation when lifecycle, published settings, MQTT topics, or cleanup behavior matter.
78
70
79
71
### Cluster Job Work
80
72
81
73
```bash
82
-
.venv/bin/pios run <job_name> --units <unit> [job options]
For worker-targeted failures, distinguish leader dispatch failures from worker-local failures. Inspect the `pios` implementation, leader API route, Huey task, and worker `/unit_api` route as appropriate.
@@ -96,8 +88,8 @@ For worker-targeted failures, distinguish leader dispatch failures from worker-l
pio mqtt -t "pioreactor/<unit>/<experiment>/<job_name>/#"
101
93
```
102
94
103
95
Use narrow MQTT topics when possible. Stop subscriptions before finalizing.
@@ -108,8 +100,8 @@ Use narrow MQTT topics when possible. Stop subscriptions before finalizing.
108
100
- For command-syntax or discovery work, smoke check the current command:
109
101
110
102
```bash
111
-
.venv/bin/pio <command> --help
112
-
.venv/bin/pios <command> --help
103
+
pio <command> --help
104
+
pios <command> --help
113
105
```
114
106
115
107
- For live cluster behavior, report exactly what was run, which unit or experiment was targeted, and any services or environment variables that mattered.
0 commit comments