> Godmode v0.19.2 documentation · Reviewed 2026-11-17
> Source: https://godmode.build/docs/v0.19.2/commands

# Command reference

Use these commands to inspect or change your local Godmode setup. They cover v0.19.2; `godmode --help` shows installed usage. Never put a secret in a command argument.

## Open and inspect

| Command | Result |
| --- | --- |
| `godmode` | Open the status screen and management actions |
| `godmode --plain` | Use static text and numbered choices |
| `godmode --no-motion` | Disable animation |
| `godmode --version` | Print the installed version |
| `godmode help` | Print the agent guide and saved key names |
| `godmode faq` | Read local help |
| `godmode intro` | Replay the looping two-stage welcome; Enter advances immediately |
| `godmode active` | Show the resolved business, key environment and scoped command |
| `godmode active --json` | Show selection names, paths and sources without values |
| `godmode active --command` | Print the exact command prefix for a pinned task |
| `godmode source` | Print the embedded Python engine |
| `godmode build-info` | Show compiler, dependencies, and engine hash |

## Credentials and providers

| Command | Result |
| --- | --- |
| `godmode setup [SLUG]` | Add or replace a provider's keys |
| `godmode provider [SLUG]` | List providers or print one guide |
| `godmode list` | Print saved names only |
| `godmode set NAME` | Save or replace through a masked prompt |
| `godmode set NAME --stdin` | Read a value from stdin |
| `godmode run NAME... -- CMD` | Start a command with selected keys |
| `godmode run VAR=NAME -- CMD` | Supply a key under another variable name |
| `godmode path` | Print the credential-file path |
| `godmode migrate` | Seal keys from an older plaintext store |
| `godmode edit` | Open the file in nano; sealed values stay encrypted |

Replace `SLUG` with a [provider slug](/docs/v0.19.2/providers), `NAME` with a saved key name, `VAR` with the variable your tool expects, and `CMD` with the command to run. Brackets mark optional arguments. See [Credentials](/docs/v0.19.2/credentials) for examples.

## Profile and agent instructions

| Command | Result |
| --- | --- |
| `godmode profile` | Edit optional profile fields |
| `godmode profile get FIELD` | Print one field |
| `godmode profile show` | Print the profile as JSON |
| `godmode profile path` | Print its file path |
| `godmode profile set FIELD` | Set a field through a visible prompt |
| `godmode profile set FIELD --stdin` | Read plain text from stdin |
| `godmode profile unset FIELD` | Remove a field |
| `godmode agents` | Review and append the agent note |
| `godmode agents --print` | Print the task note for the selected environment and business |

Use a field name from [Profile](/docs/v0.19.2/profile). Review [Agent instructions](/docs/v0.19.2/agents) before appending the note.

## Home and display settings

Place `--home DIR` before the command or set `GODMODE_HOME` to select another home. Use the same home for keys and profiles. `GODMODE_CONFIG_DIR` is an older alias.

`GODMODE_PLAIN=1` selects plain mode, `GODMODE_NO_MOTION=1` disables animation, and `NO_COLOR=1` disables color.

## Businesses and environments

Separate client keys while reusing each business profile.

```sh
godmode context create acme
godmode context map acme STRIPE_SECRET_KEY ACME_STRIPE_SECRET_KEY
godmode --context acme profile
godmode --context acme run STRIPE_SECRET_KEY CLOUDFLARE_API_TOKEN -- your-command
```

Save ACME_STRIPE_SECRET_KEY with `godmode set` before mapping it.

| Command | Result |
| --- | --- |
| `godmode use --env NAME --context BUSINESS` | Save an existing key environment and business as the default |
| `godmode use NAME` | Save this key environment with the currently resolved business |
| `godmode use --context BUSINESS` | Save this business with the currently resolved key environment |
| `godmode use --env default --context -` | Return to default keys and their own profile |
| `godmode env list --json` | List key files and safe metadata |
| `godmode env create NAME` | Create an empty key file |
| `godmode env create NAME --copy SOURCE` | Copy a complete file without replacing an existing one |
| `godmode env show NAME` | Show names and paths, never values |
| `godmode --env NAME setup` | Edit keys in one file |
| `godmode --env NAME --context BUSINESS help` | Select keys and reusable business facts |
| `godmode doctor --json` | Check local files and installation without changing them |
| `godmode update` | Update the recorded installation |
| `godmode update --version vX.Y.Z` | Install a specific published version |

Selection resolves separately for keys and business: explicit `--env` / `--context`, then `GODMODE_ENV` / `GODMODE_CONTEXT`, then the saved active pair, then the original defaults. `--context -` selects the environment's own profile. `use` saves a complete pair; an omitted choice uses the current resolved selection, including shell overrides. Saving a default does not unset those overrides. See [Businesses and environments](/docs/v0.19.2/contexts) for task pinning and recovery.
