Skip to content
General Augment Docs

CLI Configuration

The CLI stores non-secret global context in ~/.genaug/config.yaml:

base_url: https://api.generalaugment.com
active_workspace: lunar
active_project: commerce-app
profile: default
metadata: {}

It never persists management tokens, credential values, or raw runtime keys. Interactive management credentials live in the OS keychain.

Each bound app repository contains:

genaug-agent.yaml
.genaug/context.json

genaug-agent.yaml is the synchronized genaug/v3 working copy. .genaug/context.json is gitignored and retains the Project binding and base revision.

Project resolution order is:

  1. --project;
  2. repository-local context;
  3. global active Project.

Use an alternate API without storing credentials:

Terminal window
genaug --base-url http://127.0.0.1:8102 auth login

Or isolate non-secret config:

Terminal window
genaug --config ~/.genaug/team2.yaml \
  --base-url http://127.0.0.1:8102 \
  status --json

Secrets enter credential commands only from named environment variables, stdin, or browser OAuth. Runtime keys may be written directly to an ignored app environment file:

Terminal window
genaug credential set orders-api --from-env ORDERS_API_KEY
genaug credential rotate orders-api --from-stdin
genaug key create --target candidate --env-file .env.local