Reference

Commands

streb uses init as its default subcommand. Running streb with no arguments is equivalent to streb init.

Global Flags

These flags are accepted by every command:

streb init

Synopsis: streb [init] [flags]

The default command. Checks and installs all prerequisites in order. Steps run sequentially so dependencies are satisfied before tools that need them.

Exit codes

• 0 — success
• 1 — one or more prerequisites failed
• 130 — interrupted (Ctrl+C / SIGTERM)

Examples

# Interactive setup
streb init

# Non-interactive
STREB_AIHUB_KEY=sk-... streb init

streb reset

Synopsis: streb reset [--skip-*]

Reverses streb init. By default removes all configured components. Use --skip-* flags to preserve specific items.

Flags

Examples

# Remove everything
streb reset

# Keep Claude Code and Bun, reset everything else
streb reset --skip-claude-code --skip-bun

streb doctor

Synopsis: streb doctor

Runs all prerequisite checks in parallel and displays the health status. Read-only — does not install or modify anything.

Checks run:

• Authentication, Git, Git user config, Bun, Claude Code CLI, jq, yq
• Network, Disk space, Write permission, Home directory, Proxy config
• OS / architecture (informational)

Example output

$ streb doctor
  ✓  Authentication
  ✓  Git                  2.47.0
  ✓  Git user config
  ✓  Bun                  1.2.4
  ✓  Claude Code CLI      1.5.0
  ✓  jq                   1.7.1
  ✓  yq                   4.44.6
  ✓  Network
  ✓  Disk space           47.3 GB free
  ✓  Write permission
  ✓  Home directory
  ⊖  Proxy config         none configured
  ✓  OS                   linux/amd64

Status icons

streb provider

Synopsis: streb provider

Lets you switch the configured Claude auth provider (adesso AI Hub, Anthropic API key, or Claude subscription login) without a full streb init re-run. Requires streb init to have already run.

Interactively prompts to confirm the switch; in a non-interactive session the existing provider is kept unchanged. On switch, rewrites .claude/settings.json so Claude Code picks up the new provider immediately.

streb model

Synopsis: streb model

Switches the selected Claude model. Applies only to the adesso AI Hub provider — for the Anthropic API key or Claude subscription providers, the command reports that there's nothing to switch.

Fetches the live list of chat models available to the configured API key from AI Hub, then opens an interactive picker. Selecting a model updates the session and rewrites .claude/settings.json immediately.

streb secret

Synopsis: streb secret get|put|drop <key> [value] [--global]

Reads, writes, or removes a session secret in the encrypted session store (.streb/session).

--global bypasses per-project scoping and stores/reads the bare key name, for secrets shared across projects.

streb upgrade

Synopsis: streb upgrade [--check]

Checks for a newer release and upgrades in place. Behavior depends on how streb was installed:

• Homebrew — delegates to brew upgrade streb
• Scoop — delegates to scoop update streb
• Winget — delegates to winget upgrade --id adesso-ai.streb
• Direct install (install.sh / manual binary) — downloads, verifies the SHA256 checksum, and atomically replaces the running binary

--check reports whether a newer version is available without installing it.

streb version

Synopsis: streb version or streb --version

Prints the version string stamped at build time. Untagged builds print dev.

$ streb version
v1.0.0

streb completion

Synopsis: streb completion <shell>

Supported shells: bash, zsh, fish, powershell

# bash
streb completion bash > /etc/bash_completion.d/streb

# zsh
streb completion zsh > "${fpath[1]}/_streb"

# fish
streb completion fish > ~/.config/fish/completions/streb.fish

# PowerShell
streb completion powershell | Out-String | Invoke-Expression

Configuration

streb merges configuration from multiple sources at startup. The result is a single resolved config object used for the entire run. Both the global file (~/.streb/config.yaml) and the project file (.streb/config.yaml) accept any subset of the keys described below.

Config Schema

The complete configuration file schema. Both ~/.streb/config.yaml (global) and .streb/config.yaml (project) accept any subset of these keys.

# Project identity (commit this in .streb/config.yaml)
project:
  name: string            # Project name
  domain: string          # Optional: domain or environment label
  description: string     # Optional: project description
  repository: string      # Optional: repository URL

# Logging
log:
  level: string           # "debug" | "info" | "warn" | "error" (default: "info")
  format: string          # "text" | "json" (default: "text")
  file: string            # Path to log file; empty = stderr

# Output formatting
output:
  no_color: bool
  format: string          # "text" | "json"

# Retry behavior for API calls
retry:
  max_attempts: int       # default: 3
  initial_delay: duration # default: 2s
  max_delay: duration     # default: 30s
  multiplier: float       # default: 2.0

Precedence

Configuration sources, lowest priority first (later entries win):

Environment Variables

Auth env var precedence: STREB_AIHUB_KEY → ANTHROPIC_AUTH_TOKEN → ANTHROPIC_API_KEY.

Files & Directories

Add to .gitignore:

.streb/session