CLI commands

This page lists every command in gg 0.88.39, generated from gg’s own help. Run gg --help for the same list in a terminal.

Most commands accept --json to print a machine-readable result instead of text.

`gg`

The console.

`gg fly <text>|--uri <uri>|--ticket <provider>#<id>`

Open a flight.

Option	Meaning
`--repo <name>`	Which repository it is about, by its registered name
`--runner <id\|name>`	Open it for one machine
`--work-kind <name>`	Which work kind’s rules govern it
`--environment <name>`	Which charted environment it runs in
`--model <name>`	Which model it runs on, from root’s models:
`--attended`	And watch it from wherever you are
`--file <repo>:<path>[@ref]`	About a file in a registered repository, read by the runner

`gg flights [--all] [--intent <provider>#<id>|<uri>|<repo>:<path>]`

Flights in the air, or every one.

Option	Meaning
`--limit <rows> --after <cursor>`	One page of them, and where to carry on

`gg show <flight>`

One flight, by GG-42 or by id.

`gg log <flight>`

A flight’s log.

`gg facts <flight>`

What a flight recorded, and which budget held it.

`gg runners`

The runners this tenant has.

`gg watches [--limit <rows>] [--after <cursor>]`

How each watch is doing: executor, last report, cost.

`gg plan [flight]`

What must hold before a flight can start.

`gg itinerary check <file>`

What admission would do with each leg of a plan.

`gg itinerary propose <file>`

Propose a plan; nothing opens until its gate is answered.

`gg itinerary tools [--draft <name>]`

A tool server any Claude Code session drafts a plan with.

`gg manage tools`

Gg’s management layer as tools for a Claude Code session.

`gg mux mark <working|waiting|notification>`

What a mux agent’s own hooks run; always exits 0.

`gg itineraries [--intent <key>] [--limit <rows>] [--after <cursor>]`

Every plan here, and its legs.

`gg itinerary show <ITN-n>`

One plan, and every leg of it in full.

Option	Meaning
`--print-registration`	The `claude mcp add` line that registers it

`gg gates`

Flights stopped, waiting on somebody.

`gg board [--all] [--limit <rows>] [--after <cursor>]`

What has been nominated and needs somebody.

`gg board open <id> <why>`

Turn a standing nomination into a flight.

`gg board decline <id> <why>`

Say it is not going to be one.

`gg why <flight> [obligation]`

Why a flight is stopped, and what would open it.

`gg decide <flight> <obligation> <outcome> [reason]`

Open a gate, or refuse it.

`gg ground <flight> <why>`

Stop a flight that could still have been done.

`gg model <flight> <model>`

Move a flight in the air to another model root lists.

`gg take <flight> [--return <outcome> [--note <note>]]`

Take a flight over, and hand it back.

`gg runner labels`

What each runner advertises, with its disposition.

`gg runner retire <id|name>`

Take a runner out of the fleet, for good.

`gg tenant name <name>`

What this tenant is called; only somebody who administers it may say.

`gg fleet enroll --profile <name> --uses <n> --expires <duration> [--tenant | --claim [--reserve]]`

A token some machines may join with, shown once.

`gg fleet tokens`

This tenant’s enrollment tokens, without their secrets.

`gg fleet revoke <id>`

An enrollment token enrolls nothing more.

`gg runner claim|unclaim <id|name>`

Make a machine yours, or give it back.

`gg runner reserve|release <id>`

Keep your machine to your own flights, or not.

`gg runner ownership <id> tenant|open`

An admin’s word: nobody’s to claim, or anybody’s.

`gg runner watch <id|name>`

Watch it, and whatever it flies next.

`gg runner repin <id>`

Trust a runner’s key again after it changed.

`gg invite`

A link that makes somebody a second principal here.

`gg credential add --repo <slug>|--agent <name>|--tracker <key>|--analysis <key>`

`gg credential send --repo <slug>|--agent <name>|--tracker <key>|--analysis <key>`

Send it to every machine your fleet profiles say needs it; the list is printed before anything moves.

`gg credential send --runner <id|name> --repo <slug>|--agent <name>|--tracker <key>|--analysis <key>`

Put one on a machine that cannot be reached any other way.

`gg key create`

Mint this person’s key; the passphrase is prompted for.

`gg key list`

The public keys this tenant’s people have registered.

`gg credential list`

The references the control plane holds.

`gg credential rm <id>`

Forget one, here and there.

`gg credential trust-this-machine <locator>`

Let THIS machine open a credential sealed to you, so a flight here can resolve it with nobody present.

`gg agent login --runner <id|name> [--agent <name>]`

Log a runner’s agent in from here: it runs the ceremony, you visit the URL and bring back the code.

`gg airspace show|pull|diff|apply`

Its names, and its working copy.

Option	Meaning
`apply --declare-names`	Declare names it needs, under root, first

`gg airspace retire <name>`

Retire a name - always opens a gate.

`gg airspace name <role> <name> [--under <parent>]`

Declare a name a document can reach.

`gg airspace name watch <name> --personal`

Declare a watch that is yours alone; its gate is yours.

`gg airspace repositories add --name <n> --provider <p> --id <id> --path <path> [--ref <ref>] [--credential required|none] [--narrowings <dir>]`

Make a repository nameable - a new one rides a gate.

`gg envelope show`

The rules governing this tenant’s flights.

`gg strategy apply <name> <file>`

Manage a pool under the named strategy.

`gg strategy build <name>`

Build the strategy’s recipe; the pin moves when it lands.

`gg environment chart <name> [--means <predicate>]`

Chart one, so an envelope may select it - rides a gate.

`gg environments`

Every environment name an envelope may select.

`gg strategies`

What furnishes each of them, and inside which bounds.

`gg pools`

What each managed pool last attested, and when.

`gg envelope apply <file>|-`

Write them back.

`gg envelope validate <file>|-`

Check a file without sending it anywhere.

`gg config show`

Every setting, and where its value came from.

`gg config init`

Write a file seeded from what is in force.

`gg config set <key> <value>`

Change one setting.

`gg config validate <file>|-`

Check a configuration without applying it.

`gg config offered`

What your control plane offers this machine.

`gg config accept <version>`

Take the offer you just read, by version.

`gg allowance`

What the allowance this machine spends from has left.

`gg allowances`

What every allowance in the fleet has left.

`gg allowances report`

Tell the fleet what this machine’s meter says.

`gg allowances floor <name> [--session <pct>] [--week <pct>] | --clear`

Keep a share back.

`gg allowances override <name> --minutes <n> --reason <why>`

Spend somebody’s floor.

`gg doctor`

Check what gg needs to work.

`gg update`

Whether this gg is behind, and what would move it.

`gg bundle`

A redacted diagnostics bundle to send us.

`gg reference --json`

Every command and console key, as the docs site reads them.

`gg login`

`gg logout`

Forget the session here.

`gg whoami`

Who this machine is signed in as.

`gg admin grant <principal>`

Make somebody an administrator of this tenant.

`gg admin revoke <principal>`

Take it back.

`gg runner up`

Take work on this machine.

`gg runner maintain <pool>`

Keep a managed pool warm, reset and attested.

`gg service install --control-plane <url> [--enroll] [--user <name>] [--agent-binary <path>]`

Make this machine’s runner a service.

`gg service uninstall`

Remove exactly what service install wrote.

`gg version`

Binary, protocol and fact vocabulary.