Command reference
Every gma command at a glance.
CLI
Run gma --help for the short list at any time, or gma <command> --help for full flag lists. The same binary is also available as forge-gma.
Public commands
No GitMyABI account required.
| Command | Purpose | Docs |
|---|---|---|
gma init | Create a gma.config.json in the current directory. | Init and config |
gma generate | Build a typed-ABI bindings tarball. | Generate |
gma publish | Upload a bindings tarball to a registry. | Publish |
gma demo | Run an interactive walkthrough with mocked output. | — |
gma login | Sign in via GitHub OAuth (also: gma --login). | Sign in |
Authenticated commands
Available after gma login.
| Command | Purpose | Docs |
|---|---|---|
gma whoami | Show the active profile and session state. | Sign in |
gma logout | Clear the saved session. | Sign in |
gma shell | Open the interactive REPL with the full command set. | Projects and builds |
gma team <sub> | Manage teams: list, show, create, update, delete, use, check-slug, subscription, members. | — |
gma project <sub> | Manage projects: list, show, use, create, update, rename, settings, transfer, delete, check-name, check-npm, builds. | Projects and builds |
gma build <sub> | Trigger, watch, cancel, status, list, show, run, logs, artifacts, tiers, delete. | Projects and builds |
gma repo <sub> | Browse GitHub repos: list, branches, branch-info, contents, info. | Projects and builds |
gma abi <sub> | List ABIs: project, build. | Projects and builds |
gma session <sub> | Inspect or refresh the active session: status, whoami, info, refresh, clear. | — |
Related
- CLI overview
What the gma CLI does and when to use it.
- Install the CLI
Install the gma CLI from npm.
- Sign in with the CLI
Authenticate the gma CLI with your GitMyABI account.
- Projects and builds (CLI)
Trigger, watch, and manage hosted builds from the CLI.
- Environment variables
Environment variables the gma CLI reads.