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.

Sessions

Sessions are created in the CLI, persisted by the server, and later reopened from the terminal or dashboard surfaces. A session stores the conversation plus the last mode and model used so you can resume work with context intact.

Create

Starting a new prompt creates a session on the server. The initial title usually comes from your current directory name, with a fallback to "CLI session".

Reopen

Use /sessionsto browse history, search by title, and reopen an existing thread.

Rename

Session titles can be updated from the session view. Rename is persisted to the backend so the updated title appears the next time you browse history.

Session status

Each session shows a status on the dashboard: New before its first response, Waiting while a response is generating, Complete once a response finishes normally, or Interrupted if you pressed Esc before it finished.