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.

Local tools

Tool side effects run locally inside your project. Even though the server advertises and validates the tool contracts, the CLI performs the actual file reads, edits, web fetches, and shell execution.

PLAN tools

readFilelistDirectoryglobgrepwebfetch

BUILD adds

writeFileeditFilebash

Path safety

Tool paths are resolved relative to the active project and blocked if they point outside that directory.

Large output handling

Large file reads and web outputs are truncated with warnings so the conversation stays manageable while still exposing enough content for follow-up reads.

Shell execution

The bashtool runs locally with a default timeout of 45 seconds and uses an available shell such as bash, sh, PowerShell, or cmd depending on your machine.

Permission checks run first

Before any tool listed above actually runs, GBAM checks it against your Permissions settings. Depending on your configuration, an action may run immediately, ask you to confirm, or be blocked outright. See Permissions for details.