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, 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 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. Review Agent instructions 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.
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-commandSave 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 for task pinning and recovery.