Models and frameworks
Command reference: models and frameworks.
Generated from the CLI catalog at fd47c2b.
runtimes ls
Installed runtimes, versions, logins and capabilities.
airship runtimes lsEffects: read. Agent safe: yes. Scope: remote.
Exits: 0, 1, 2, 7.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema models; data reference #/$defs/data_runtimes_ls.
models ls
Model roster per runtime per host.
airship models ls [--runtime claude|codex] [--all] [--refresh]Effects: read. Agent safe: yes. Scope: fanout.
Exits: 0, 1, 2, 7, 8.
--host: host id or all. --dry-run: unsupported.
JSON schema: airship schema models; data reference #/$defs/data_models_ls.
| Argument | Meaning |
|---|---|
--runtime | only this runtime |
--all | include hidden entries |
--refresh | bypass the 10-minute roster cache |
models defaults
Effective model, effort and ctx limit per runtime × role.
airship models defaultsEffects: read. Agent safe: yes. Scope: remote.
Exits: 0, 1, 2, 7.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema models-defaults; data reference #/$defs/data_models_defaults.
models use
Set the default model for a runtime (role, tier or host).
airship models use <runtime> <model> [--role default|orchestrator|lane|agent] [--tier T] [--effort E]Effects: write. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 8, 14.
--host: host id. --dry-run: accepted.
Related JSON schema: airship schema models-defaults.
| Argument | Meaning |
|---|---|
runtime | runtime |
model | model id, or default to inherit the next configured value |
--role | which role default |
--tier | write the tier's model instead |
--effort | also set the effort |
models ctx
Set the context limit for a runtime.
airship models ctx <runtime> <N|PCT|auto>Effects: write. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 8.
--host: host id. --dry-run: accepted.
Related JSON schema: airship schema models-defaults.
| Argument | Meaning |
|---|---|
runtime | runtime |
limit | tokens (350k), a share (70%), or auto |
tiers ls
The framework's tiers with resolved models.
airship tiers lsEffects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema tiers; data reference #/$defs/data_tiers_ls.
role ls
The framework's roles.
airship role lsEffects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema roles; data reference #/$defs/data_role_ls.
framework ls
Available frameworks.
airship framework lsEffects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema framework; data reference #/$defs/data_framework_ls.
framework show
A framework's README, blocks and provenance.
airship framework show [<name>] [--resolved] [--block B]Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2, 4, 14.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema framework; data reference #/$defs/data_framework_show.
| Argument | Meaning |
|---|---|
name | framework name or path |
--resolved | the merged framework.json with $from provenance |
--block | only this block (roles., brief., tiers, …) |
framework describe
Roles, tiers, settings and ticks (the app and guide feed).
airship framework describeEffects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema framework-describe; data reference #/$defs/data_framework_describe.
framework use
Switch the active framework.
airship framework use <NAME|PATH>Effects: write. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 8, 14.
--host: host id or all. --dry-run: accepted.
Related JSON schema: airship schema framework.
| Argument | Meaning |
|---|---|
name | framework name or path |
framework new
Scaffold a child framework.
airship framework new <name> [--extends NAME] [--block B]...Effects: write. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 14.
--host: host id. --dry-run: accepted.
Related JSON schema: airship schema framework.
| Argument | Meaning |
|---|---|
name | new framework name |
--extends | parent framework |
--block | copy this block from the parent |
framework eject
Flatten the framework chain into one standalone directory.
airship framework eject [<name>] [--to DIR] [--use]Effects: write. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 14.
--host: host id. --dry-run: accepted.
Related JSON schema: airship schema framework.
| Argument | Meaning |
|---|---|
name | framework to eject (default: active) |
--to | target directory |
--use | switch to the ejected framework |
framework diff
Changes against the parent or the ejected-from framework.
airship framework diff [<name>]Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2, 4, 14.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema framework; data reference #/$defs/data_framework_diff.
| Argument | Meaning |
|---|---|
name | framework name |
framework validate
Validate a framework.
airship framework validate [<NAME|PATH>] [--deep] [--strict]Effects: read. Agent safe: yes. Scope: fanout.
Exits: 0, 1, 2, 4, 7, 8, 14.
--host: host id or all. --dry-run: unsupported.
JSON schema: airship schema check; data reference #/$defs/data_framework_validate.
| Argument | Meaning |
|---|---|
name | framework name or path |
--deep | also run every hook in dry-run mode |
--strict | unknown keys become errors |
framework settings
Get or set framework settings.
airship framework settings [<key>] [<value>]Effects: read. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 8, 14.
--host: host id. --dry-run: accepted.
JSON schema: airship schema config; data reference #/$defs/data_framework_settings.
| Argument | Meaning |
|---|---|
key | dotted setting key |
value | new value (setting is a write) |