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.

Install & first run

GBAM is distributed as a global CLI package. After installation, open a terminal in the project you want to work on and launch the app from that directory.

npm install -g gbam-dev
gbam

What happens on first use

The home screen lets you enter a prompt, choose a mode, and start a session. New sessions are created by the CLI and then persisted on the server.

Working directory matters

Run GBAM inside the repository you want the agent to inspect. The CLI uses your current project path to resolve files, create or read AGENTS.md, and scope local tool execution safely inside that workspace.

Supported platforms

GBAM currently supports macOS (Intel and Apple Silicon) and Windows (x64 and ARM64). Linux support is not available yet.