spec-editor agents
Contours, roles and slots of the delivery loop.
Usage
spec-editor agents [OPTIONS] COMMAND [ARGS]...Subcommands
| Subcommand | Description |
|---|---|
drain |
Soft stop: no new claims, runs in flight finish. |
slots |
Show slots busy/total per role and the worker permit pool. |
start |
Idempotently start the execution contour and the workers. |
status |
Show contours, roles, slots busy/total and tasks (delivery_status). |
stop |
Immediate stop: runs are cut and their tasks return to the queue. |
spec-editor agents drain
Soft stop: no new claims, runs in flight finish.
Usage
spec-editor agents drain [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--role |
text | Only this role | |
--timeout |
number | Seconds before runs are cut | |
--path, -p |
path | . |
Project path |
--all |
flag | Every project of the installation |
spec-editor agents slots
Show slots busy/total per role and the worker permit pool.
slots set R=N changes the slots.
Usage
spec-editor agents slots [OPTIONS] [COMMAND] [ARGS]...Options
| Option | Type | Default | Description |
|---|---|---|---|
--json |
flag | Machine-readable output | |
--path, -p |
path | . |
Project path |
spec-editor agents slots set
Set the slot count of roles: R=N [R=N...] or R N.
The running execution contour applies the new counts without being
restarted (worker_set_slots).
Usage
spec-editor agents slots set [OPTIONS] ASSIGNMENTS...Arguments
| Argument | Required |
|---|---|
ASSIGNMENTS |
yes, repeatable |
Options
| Option | Type | Default | Description |
|---|---|---|---|
--persist |
flag | Also write the value to the config |
spec-editor agents start
Idempotently start the execution contour and the workers.
Without --role, this one command starts the whole system of the project: the
control contour (the project’s MCP server with plugins, the engine and the
managers) and then the workers of the execution contour, with the per-role slot
counts from the configuration. A control contour that is already running is not
duplicated or restarted; one that has exited is started again.
Usage
spec-editor agents start [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--role |
text | Only this role’s workers | |
--path, -p |
path | . |
Project path |
--all |
flag | Every project of the installation |
spec-editor agents status
Show contours, roles, slots busy/total and tasks (delivery_status).
Usage
spec-editor agents status [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--json |
flag | Machine-readable output | |
--path, -p |
path | . |
Project path |
--all |
flag | Every project of the installation |
spec-editor agents stop
Immediate stop: runs are cut and their tasks return to the queue.
A stop of one role leaves the other roles untouched; a full stop is journalled with its reason in the installation journal. implements
Usage
spec-editor agents stop [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--role |
text | Only this role | |
--reason |
text | operator |
Recorded for a full stop |
--path, -p |
path | . |
Project path |
--all |
flag | Every project of the installation |