DocumentationCLI commands

CLI commands

The CLI supports one-shot queries, persistent terminal sessions, tool discovery, and structured output for automation.

03 sections6 min readUpdated for preview
On this page
  1. 01Run an agent
  2. 02Inspect sessions and tools
  3. 03Common query options
01

Run an agent

A prompt without a subcommand runs a one-shot query. Use repl for a line-oriented session or tui for the full-screen interface.

Command
buildstax [options] "PROMPT"
buildstax repl [options]
buildstax tui
02

Inspect sessions and tools

Session commands are scoped to a repository. Catalog commands report tools available in the installed build.

Command
buildstax sessions [--cwd PATH] [--json]
buildstax session-info
buildstax catalog-summary
buildstax tool-search QUERY
03

Common query options

Use --help on the installed binary for the complete list.

  • --cwd PATH and --resume REF
  • --provider NAME, --model NAME, and --api-key-env NAME
  • --permission-mode MODE with repeatable permission rules
  • --json, --max-turns N, and --wall-budget SEC
  • --verify-on-finish and --finish-verifier-command CMD