Command reference

Every command the gigadrive binary accepts, with its exact arguments and flags. The alias gn works everywhere gigadrive does.

Every command

Listed in the order gigadrive --help prints them.

Conventions

Every command and subcommand also accepts --help / -h, --version, --wizard, --completions <shell> and --log-level <level>, described in the CLI overview.

Boolean flags have no negated form, so --no-yes and --no-sensitive do not exist. Omitting the flag is how you turn it off.

Running a group on its own, such as gigadrive env or gigadrive ai usage, prints nothing and exits 0. An unknown subcommand at any depth exits 1 and names the root command, not the group you typed, so gigadrive apps bogus reports Invalid subcommand for gigadrive - use one of 'login', 'logout', ....

Authentication

gigadrive login, gigadrive logout and gigadrive whoami take no arguments and no options. See Authentication.

Project link

gigadrive link

gigadrive unlink

No arguments, no options. Details in Project linking.

Applications

gigadrive apps list

Prints <id> <name> (<organization>) per line, then a count. An empty result prints No applications found.

gigadrive apps create

gigadrive apps create --org 0195c0aa-0000-7000-8000-0000000000ff --name "Marketing site"
gigadrive apps create -o 0195c0aa-0000-7000-8000-0000000000ff -n "API" --slug api --root-directory apps/api

Environment variables

--org switches these commands to organization scope. Without it they use --app, and without that the linked application.

gigadrive env list

Prints KEY=value per line. Sensitive variables print as KEY=***.

gigadrive env set

The argument splits at the first =, so values may contain further = characters. A missing or leading = reports Invalid format. Use KEY=VALUE, e.g. "gigadrive env set DATABASE_URL=postgres://...".

gigadrive env rm

Matches on ID or key. There is no confirmation prompt.

gigadrive env pull

Application scope only. This command has no --org.

Only non-sensitive values come back. Withheld secrets are reported as Skipped <n> sensitive variable(s); secrets live only in production/preview environments.

Deployments

gigadrive deploy

gigadrive platform deploy is the same command under a legacy name, with the same three flags. Full behaviour is on Deploy.

gigadrive deployments list

--status accepts exactly one of:

With no --app in an unlinked directory, no application filter is applied at all.

gigadrive deployments inspect

No options. Prints the ID, application, status, timestamps and, when there are any, the deployment's hostnames.

Local development

gigadrive setup

Links the directory if needed, pulls the application's non-sensitive variables, provisions API credentials and writes everything to one file. Credentials are always provisioned, so there is no --with-credentials flag here.

An already linked directory ignores --app and --org, and says so: Note: this directory is already linked to <id>; ignoring --app/--org. Run "gigadrive unlink" first to target a different application.

gigadrive build

No arguments, no options. Runs a production install and build in the current directory, using the package manager implied by the lock file, with NODE_ENV=production set. It needs a package.json with a build script, or it stops with No package.json found or No build script found in package.json.

AI Gateway

--org defaults to the organizationId in the project link. Without either, these commands report No organization is linked. Pass --org <id> or re-run "gigadrive link".

gigadrive ai usage summary and gigadrive ai usage requests

summary prints JSON. requests prints one line per event and a count.

gigadrive ai usage export

The four shared usage options also apply, plus:

gigadrive ai usage export --from 2026-07-01T00:00:00Z --to 2026-08-01T00:00:00Z --out july.csv

gigadrive ai budgets get

gigadrive ai budgets set

Accepts a bare JSON array or an object shaped { "budgets": [...] }, and replaces the whole budget set. An empty array clears every budget.

gigadrive ai policies get

Prints the policy as JSON, or the line No policy set.

gigadrive ai policies set

There is no --app here. Target an application by putting "applicationId" inside the JSON body.

gigadrive ai models list

No arguments, no options. Prints <id> <name> (ctx <contextWindow>) per line.

gigadrive ai models get

No options.

gigadrive ai chat

Sends exactly one user message. There is no system prompt, temperature or max-tokens flag.

gigadrive ai chat "Summarise this changelog" --model openai/gpt-4o
gigadrive ai chat - --model openai/gpt-4o --stream < CHANGELOG.md

Diagnostics

gigadrive debug config

No arguments, no options. Prints the path of the config file it found, or null when the configuration came entirely from framework detection, followed by the normalized configuration as JSON.

Environment variables the CLI reads

Setting any one of the four non-interactive variables makes the CLI ignore the stored login entirely.