Documentation

The CLI reference, generated from each release. Pick a version to see its exact commands.

Turborg CLI reference

Generated from the source on each release — do not edit by hand.

Commands

turborg

Turborg — an authenticated, metered AI coding agent (run as turborg or borg)

turborg [question] [flags]

Flags:

      --attach string   attach to a saved session by id or prefix, or no value for this dir's latest (run 'borg sessions')
      --debug           verbose debug diagnostics (also via the 'debug' setting / BORG_DEBUG_ENABLED)
      --model string    model codename (e.g. floko, chuppa); overrides BORG_MODEL
      --resume          resume the most-recently-active session (any directory)
      --think           enable reasoning/thinking mode (also via the 'think' setting)

turborg auth

Manage borg authentication

turborg auth

turborg auth login

Log in via the browser (or --device for headless/SSH)

turborg auth login [flags]

Flags:

      --device   use the device-authorization flow instead of the browser

turborg auth logout

Remove the stored credentials

turborg auth logout

turborg auth status

Show the configured endpoints and login status

turborg auth status

turborg completion

Generate the autocompletion script for the specified shell

turborg completion

turborg completion bash

Generate the autocompletion script for bash

turborg completion bash

Flags:

      --no-descriptions   disable completion descriptions

turborg completion fish

Generate the autocompletion script for fish

turborg completion fish [flags]

Flags:

      --no-descriptions   disable completion descriptions

turborg completion powershell

Generate the autocompletion script for powershell

turborg completion powershell [flags]

Flags:

      --no-descriptions   disable completion descriptions

turborg completion zsh

Generate the autocompletion script for zsh

turborg completion zsh [flags]

Flags:

      --no-descriptions   disable completion descriptions

turborg help

Help about any command

turborg help [command]

turborg learn

Study the current directory and write a BORG.md project-context file

turborg learn [flags]

Flags:

      --model string   model codename (e.g. floko, chuppa); overrides BORG_MODEL
      --think          enable reasoning while studying the project

turborg purge

Delete all saved REPL sessions

turborg purge [flags]

Flags:

  -y, --yes   skip the confirmation prompt

turborg sessions

List saved REPL sessions for this directory (--all for every directory)

turborg sessions [flags]

Flags:

      --all   list sessions from every directory, not just this one

turborg settings

View or change persistent settings (~/.config/borg/settings.json)

turborg settings

turborg settings get

Print one setting's current value

turborg settings get <key>

turborg settings list

Show every setting with its current value

turborg settings list

turborg settings set

Change a setting and persist it (an exported BORG_* still overrides it)

turborg settings set <key> <value>

turborg update

Update to the latest release

turborg update [flags]

Flags:

      --check   only check for a newer version, don't install

REPL slash commands

Type these inside the interactive REPL (run turborg with no arguments).

Command Description
/model pick a model (interactive list, or /model )
/think toggle reasoning [on
/effort pick reasoning effort (interactive list, or /effort )
/sessions switch session in this directory (interactive list, or /sessions )
/learn study this project and write BORG.md
/context show context-window usage + a breakdown
/compact summarize the conversation to free up context
/settings view & change persistent settings (or /settings )
/upgrade upgrade your plan (opens xShellz pricing page)
/usage show plan, quota caps, and usage
/status show login, plan, usage, and settings
/login log in to xShellz (browser or device)
/logout remove the stored credentials
/privacy how borg handles your data + policy link
/output show the last tool's FULL output (or ctrl+o)
/clear reset the conversation
/purge delete ALL saved sessions
/update update to the latest release
/help show detailed help
/exit quit (the session is saved)

Settings

Persist with turborg settings set <key> <value> or the REPL /settings. Each maps to a BORG_* environment variable (an explicit export always wins).

Setting Env var Type Default Description
escalate_model BORG_ESCALATE_MODEL off | axiom `` tier up to a stronger model once a task keeps struggling (off = never, no surprise spend)
think BORG_THINK on/off false start new sessions with reasoning on (per-session /think still wins)
git_attribution BORG_GIT_ATTRIBUTION on/off true add a Turborg Co-Authored-By trailer to commits borg makes
force_device BORG_FORCE_DEVICE on/off false skip the browser/PKCE flow and use the device flow
debug BORG_DEBUG_ENABLED on/off false verbose tool / LLM / HTTP traces
learn_stale_after BORG_LEARN_STALE_AFTER integer 25 git repos only: remind to run /learn once BORG.md is this many commits behind HEAD (off = never)
format BORG_FORMAT_CMD text `` override the formatter run after each edit ({file} = path); empty = auto-detect the project's own formatter