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.

Dashboard & billing

The website complements the CLI by handling account-facing surfaces. Billing actions start from the terminal, but the actual pages open in your browser.

Buy more credits

Run /upgradeto open the pricing page and choose a credit pack. Credits are sold directly in Naira - no dollar card required.

Check your usage

Run /usageto open your usage dashboard in your browser.

Free trial

New accounts start with 100 free trial credits automatically - no purchase needed to try GBAM.

Credit expiry

Both trial and purchased credits are valid for 6 months from the date they were granted. Your dashboard shows the exact expiry date for each batch, and flags any credits expiring soon.

Credit enforcement

Credit checks, usage metering, and ledger updates are server responsibilities. The CLI only initiates the flow and displays the results. If you interrupt a response before it finishes, you may still be charged for the tokens already generated up to that point.

Dashboard sections

  • Overview - your current balance, recent sessions, and recent transactions at a glance.
  • Sessions - full session history, searchable by title, path, mode, model, or status.
  • Usage - a detailed log of every credit transaction on your account.
  • Limits - optional daily and monthly spending caps.
  • Permissions - default tool rules and protected paths. See Permissions.