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.

Troubleshooting

The login tab opens but the CLI does not complete sign-in

Make sure you finish the browser flow completely and that the local callback is allowed to open on your machine. Then retry/login.

The agent cannot find my project files

Start GBAM from the repository you want to work in. Tool access is scoped to the current project path rather than to arbitrary locations on disk.

I need analysis only, not code changes

Switch to PLAN with /agentsor by pressing Tab. PLAN keeps tool access read-only.

Streaming output is too long

Press Escwhile the assistant is streaming to interrupt the current response.

GBAM keeps asking to confirm the same kind of action

"Always" only remembers the exact file or command you approved, not the whole tool category. If you'd rather stop being asked for a category of actions entirely (for example, all shell commands), set that category to Allow on the Permissions page in your dashboard.

Install fails or "no prebuilt binary" on Linux

GBAM does not currently publish a Linux build. macOS and Windows are supported today; Linux support is planned.