Projects and builds (CLI)

The commands below are only available after gma login. They mirror what you can do in the web app, scriptable from the terminal. The same subcommands are also available inside gma shell.

gma shell

gma shell opens an interactive REPL with the full command set, including the groups below. Use it for exploration; use the top-level commands for scripting.

gma project

Subcommands:

• use — set the active project for subsequent commands.
• list (alias ls), show, create (alias new), update (alias edit), rename, settings, transfer, delete (alias rm), check-name, check-npm, builds.

Run gma project --help or gma project <sub> --help for the full flag set.

gma build

Trigger and observe hosted builds.

• gma build trigger <project> — flags: --profile <name>, --api-url <url>, --watch, --json. (Alias: rebuild.)
• gma build watch <buildId> — flags: --profile, --api-url, --poll-interval <seconds>. (Alias: follow.)
• gma build cancel <buildId> — flags: --profile, --api-url.
• gma build status <buildId> — flags: --profile, --api-url, --json.
• Other shell-style subcommands: list (alias ls), show, run, logs, artifacts, tiers, delete (alias rm).

gma repo

Browse the GitHub repositories accessible to the active session.

• list — list repositories.
• branches — list branches for a repository.
• branch-info — show metadata about a branch.
• contents — list a path inside a repository.
• info — show repository metadata.

gma abi

• project — list ABIs indexed for a project.
• build — list ABIs produced by a specific build.

gma session

• status — high-level session status.
• whoami — alias for the top-level gma whoami.
• info — verbose session info.
• refresh — refresh the access token.
• clear (alias cls) — clear the terminal screen (only inside gma shell).

gma team

Manage teams, memberships, slugs, and subscription state with gma team --help. Subcommands include list, show, create, update, delete, use, check-slug, subscription, members.