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.

Safety boundaries

GBAM's safety model starts with separation of responsibility: the backend decides the tool request, but the CLI performs the local action. Mode and Permissions then work together as two independent layers on top of that split.

Why this is safer

  • The server does not have direct filesystem access to your codebase.
  • Local file and shell actions stay in the terminal process.
  • PLAN provides a read-only operating mode for inspection work.
  • Tool path resolution is scoped to the active project.

Per-action permissions

Beyond mode, every individual tool call is checked against your Permissions rules and can be set to run automatically, ask for confirmation, or be denied outright - with certain sensitive paths always protected regardless of your other settings.

What to remember

If you want analysis only, choose PLAN. If you want direct edits or command execution, choose BUILD, review the repository-specific guidance in AGENTS.md, and configure Permissions to match how much you want to confirm yourself versus let run automatically.