CLI Installation

genaug requires Python 3.12 or newer.

Install

uv tool install general-augment-cli==0.5.0
genaug --version
uvx --from general-augment-cli==0.5.0 genaug --version

From a General Augment source checkout:

uv tool install --editable ./packages/cli
uv run --project packages/cli genaug --version

Releases are published only by the protected package-release workflow. Before a protected release completes, source-checkout commands are for development only. Release operators must install the exact candidate wheel and record its SHA-256 for hosted acceptance evidence; a source checkout is not a substitute for the packaged artifact at the external gate.

Authenticate

genaug auth login
genaug auth whoami --json
genaug doctor --json

Browser OAuth material is stored in the OS keychain. The config file contains only non-secret context. Runtime keys are separate Project/target credentials used only by the app backend.

Start in the app repository

genaug launch \
  --app-root . \
  --project-name "My App" \
  --project-slug my-app \
  --issuer-url https://app.example.com \
  --jwks-url https://app.example.com/.well-known/jwks.json \
  --audience my-app \
  --user-id-claim sub \
  --callback-base-url https://app.example.com \
  --env-file .env.local \
  --wait

Next: commands and configuration.