GBAM_
CLI-first product docs

GBAM CLI user manual

GBAM is a terminal chat app for working with AI conversations and real project context. The CLI is the part of the system that can access your local repository, read and edit files, and run local commands. The server handles authentication, persistence, model orchestration, billing, and streamed responses.

Sign in & auth

GBAM uses a browser-linked login flow instead of asking you to manage API keys in the terminal. When you run /login, the CLI opens your browser, the website continues the auth flow, and control is handed back to the terminal when sign-in completes.

How the flow works

  1. The CLI starts a temporary localhost callback server.
  2. The browser opens to the GBAM web experience.
  3. The website and auth provider complete identity verification.
  4. The server redirects back to the local CLI callback.
  5. The CLI stores the returned bearer token locally.

Local credential storage

Auth state is stored on your machine in~/.gbam/auth.jsonwith owner-only permissions where supported. If the server later returns 401, the CLI clears local auth and asks you to sign in again.