Skip to content
fsuite

💻 fbash

Token-budgeted shell execution with classification and session state

Section titled “Token-budgeted shell execution with classification and session state”

fbash is part of the fsuite toolkit — a set of fourteen CLI tools built for AI coding agents.

Help output

Section titled “Help output”

The content below is the live --help output of fbash, captured at build time from the tool binary itself. It cannot drift from the source — regenerating the docs regenerates this section.

fbash — token-budgeted shell execution for fsuite


USAGE
  fbash --command '<cmd>' [options]
  fbash '<cmd>' [options]


OPTIONS
  --command <cmd>       Bash command to execute (or pass as positional arg)
  --max-lines <n>       Cap stdout to n lines (default: 200)
  --max-bytes <n>       Cap stdout to n bytes (default: 51200)
  --json                Parse command output as JSON
  --cwd <path>          Working directory (overrides session CWD)
  --timeout <secs>      Timeout in seconds (auto-tuned by class if omitted)
  --env <KEY=VALUE>     Environment override (repeatable)
  --filter <regex>      Regex filter for output lines
  --quiet               Suppress stdout/stderr, return exit code + metadata
  --tag <label>         Label for fcase event logging
  --background          Run in background, return job_id
  --tail                Keep tail instead of head when truncating
  -o, --output <fmt>    Output format: pretty (default) or json
  --history             Show command history from session
  --version             Show version
  -h, --help            Show this help


INTERNAL COMMANDS
  __fbash_history       Return command history
  __fbash_session       Return full session state
  __fbash_reset         Clear session state
  __fbash_poll <id>     Check background job status
  __fbash_jobs          List background jobs
  __fbash_set_case <s>  Set active fcase slug
  __fbash_clear_case    Clear active fcase


EXAMPLES
  fbash --command 'git status'
  fbash --command 'npm test' --tail --max-lines 100
  fbash --command 'find . -name "*.ts"' -o json
  fbash --command 'npm run build' --background
  fbash --command '__fbash_poll fbash_1712035200_12345'

See also

Section titled “See also”