Lanes
Command reference: lanes.
Generated from the CLI catalog at fd47c2b.
lane
Start a framework role as a lane.
airship lane <role> [<ref>] [--tier T] [--weight light|heavy] [--runtime claude|codex] [--model M] [--effort E] [--permissions ask|auto] [--set k=v]... [--prompt T] [--name NAME]Effects: write. Agent safe: yes. Scope: auto.
Exits: 0, 1, 2, 3, 4, 6, 7, 14.
--host: host id or auto. --dry-run: accepted.
Related JSON schema: airship schema unit.
| Argument | Meaning |
|---|---|
role | framework role |
ref | the role's reference (issue, PR, text) |
--tier | framework tier |
--weight | placement weight |
--runtime | agent runtime |
--model | model id |
--effort | effort level |
--permissions | stricter than the host only |
--set | framework setting for this lane |
--prompt | extra task text |
--name | override the role's name template |
lane run
Run a plain command as a oneshot lane.
airship lane run <name> [--weight light|heavy] [--tag k=v]... [--cwd D | --worktree] [--base REF] -- ARGV…Effects: write. Agent safe: yes. Scope: auto.
Exits: 0, 1, 2, 3, 4, 6, 7.
--host: host id or auto. --dry-run: accepted.
Related JSON schema: airship schema unit.
| Argument | Meaning |
|---|---|
name | unit name |
--weight | placement weight |
--tag | framework tag k=v |
--cwd | working directory |
--worktree | new git worktree |
--base | worktree base ref |
argv | command to run, after -- |
lane ls
List lanes (= ls --role lane).
airship lane lsEffects: read. Agent safe: yes. Scope: fanout.
Exits: 0, 1, 2, 7, 8.
--host: host id or all. --dry-run: unsupported.
JSON schema: airship schema unit; data reference #/$defs/data_lane_ls.
lane stop
Stop a lane (= stop).
airship lane stop <target>Effects: write. Agent safe: yes. Scope: remote.
Exits: 0, 1, 2, 4, 5, 6, 7, 9.
--host: host id. --dry-run: accepted.
| Argument | Meaning |
|---|---|
target | [host:]name |
lane reap
Reap finished lanes (= reap --role lane).
airship lane reapEffects: write. Agent safe: yes. Scope: fanout.
Exits: 0, 1, 2, 7, 8.
--host: host id or all. --dry-run: accepted.