Discover
Command reference: discover.
Generated from the CLI catalog at fd47c2b.
guide
Agent-facing guide to airship, rendered for the caller.
airship guide [--for auto|external|orchestrator|lane] [--format md|skill|agents-md]Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema commands; data reference #/$defs/data_guide.
| Argument | Meaning |
|---|---|
--for | audience (auto picks from whoami) |
--format | output format |
commands
The command catalog (machine-readable with --json).
airship commands [--all]Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema commands; data reference #/$defs/data_commands.
| Argument | Meaning |
|---|---|
--all | include runner and internal commands |
help
Help for one command.
airship help [<command>]…Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema commands; data reference #/$defs/data_help.
| Argument | Meaning |
|---|---|
command | command path, e.g. move check |
schema
JSON Schemas for envelopes and outputs.
airship schema [<name>] [--raw]Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema commands; data reference #/$defs/data_schema.
| Argument | Meaning |
|---|---|
name | schema name (omit to list) |
--raw | print the bare schema document with no envelope |
whoami
Who is calling, and what that caller may do.
airship whoamiEffects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema whoami; data reference #/$defs/data_whoami.
version
Version, schema and API levels of this host.
airship versionEffects: read. Agent safe: yes. Scope: remote.
Exits: 0, 1, 2, 7.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema host; data reference #/$defs/data_version.
doctor
Check this host (and the mesh) for problems.
airship doctor [--mesh] [--canary] [--live] [--repair] [--strict]Effects: read. Agent safe: yes. Scope: fanout.
Exits: 0, 1, 2, 6, 7, 8.
--host: host id or all. --dry-run: unsupported.
JSON schema: airship schema check; data reference #/$defs/data_doctor.
| Argument | Meaning |
|---|---|
--mesh | check every host reaches every other |
--canary | start a throwaway stub unit end to end |
--live | with --canary: use the real runtimes |
--repair | rebuild missing state from tmux tags |
--strict | treat warnings as failures |