Complete Reference

CLI Commands & Skills

Every streb CLI command with its flags, and the full catalogue of Claude Code commands, skills, and task operations installed by streb.

Skills Reference CLI Reference

Skills Reference

All Claude Code slash commands, structured workflows, autonomous agents, and Beads operations installed by streb. Use category and phase filters to find what you need.

atomic

Single-purpose operations that complete quickly. Direct execution, no quality gate.

workflow

Structured workflows with quality gates. Gate → Execute → Verify (GEV pattern).

autonomous

Complex multi-step tasks using the Ralph Wiggum iteration loop until COMPLETE or BLOCKED.

beads

Git-backed issue tracking CRUD. All operations on the local JSONL issue store.

Category:

Phase:

Command	Arguments	Description	Category	Phases

0 skills shown

CLI Reference

All streb commands and their available flags. Global flags apply to every command.

Jump to: Global Flags init run update upgrade doctor status uninstall version config logs audit req completion

Global Flags

Available on all commands

-v, --verbose Enable verbose output

--no-color Disable colored output

--no-interactive Disable interactive prompts and TUI interactions

--output Output mode: auto (default), interactive, plain, json. Replaces per-command --json flags.

streb init

Initialize Claude Code / Beads tooling and project setup. Idempotent — safe to run multiple times.

-y, --yesAccept defaults and skip confirmation prompts

--profile <name>Setup profile: default, minimal, full, ci

--preset <name>Project preset: fullstack, backend, data-science

--config <ref>Apply a config reference / hash

--containerPrepare container runtime setup

--config-strategyConfig handling: merge, backup, skip, overwrite

--skip-authSkip authentication / API key prompts

--skip-toolsSkip tool installation steps

--skip-claudeSkip Claude Code installation

--skip-beadsSkip Beads CLI installation

--skip-bduiSkip Beads UI installation

--skip-templatesSkip template copying

--skip-pluginsSkip plugin installation

--skip-jiraSkip Jira integration setup

--skip-daggerSkip Dagger CLI installation

--skip-container-useSkip Container Use installation

--skip-ralphSkip Ralph loop setup

--jira-url <url>Jira project URL for non-interactive setup

--dry-runShow actions without executing

--jsonOutput result as JSON (deprecated: use --output json)

--resumeAuto-resume from checkpoint

--freshIgnore checkpoint and start fresh

--headlessEnable headless / CI setup options

--output-dir <path>Output directory for headless setup files

--project-nameFill project name placeholder in templates

--project-domainFill project domain placeholder in templates

--max-iterationsRalph loop iteration limit

--timeout-minutesRalph task timeout in minutes

streb run

Run autonomous Ralph loop, interactive session, or attach to a running session

autonomous streb run [prompt-or-task-id]

Iterative Ralph Wiggum loop — runs Claude inside a Dagger container, iterating until COMPLETE or BLOCKED. Requires Docker and Dagger. If a positional argument matches a Beads task ID pattern, it is treated as a task ID; otherwise it is used as the prompt.

[prompt-or-task-id]Positional arg — prompt text or Beads task ID (e.g. streb run "Refactor auth" or streb run streb-abc1)

--prompt <text>Prompt via flag (overrides positional arg)

--task-id <id>Beads task ID (overrides positional arg; loads task details as prompt)

--max-iterations <n>Ralph loop iteration limit (default: 100)

--max-turns <n>Max agentic turns per Claude invocation (default: 5)

--timeout-minutes <n>Wall-clock timeout in minutes (default: 60)

--output-dir <path>Directory for output artifacts (default: .agent-output)

--github-token <token>GitHub token for git push and PR creation (auto-read from .env if not provided)

--remote-url <url>Git remote URL (auto-detected from git remote if not provided)

--jsonOutput machine-readable JSON result

subcommand streb run interactive

Interactive Claude Code session inside a Dagger container. Requires Docker and Dagger.

--task-id <id>Task ID context (loads task into Claude's awareness)

--uiShow Dagger build UI progress on stderr

subcommand streb run attach

Attach to a running agent session. Requires container-use.

--stopDelete the container environment after detaching

--jsonOutput running sessions as JSON

streb update

Update bundled tools (Claude Code, Beads CLI, Beads UI). Without flags, updates all.

--claudeUpdate only Claude Code

--beadsUpdate only Beads CLI

--bduiUpdate only Beads UI

--checkCheck for available updates without installing

--jsonOutput update result as JSON (deprecated: use --output json)

streb upgrade

Upgrade the streb binary itself (not the bundled tools).

--checkCheck for a new version only, do not install

--forceReinstall even if already up-to-date

--jsonOutput upgrade result as JSON (deprecated: use --output json)

--migrate-configPerform config migration to v2 format (default: true)

--backupCreate a backup before migration (default: true)

--dry-runShow migration plan without applying

streb doctor

Run diagnostic checks for environment health. Reports tool versions, config validity, and connectivity.

--jsonOutput diagnostic report as JSON (deprecated: use --output json)

--fixAttempt automatic fixes where supported

streb status

Show environment status: installed tools, versions, config, and service connectivity.

--jsonOutput status report as JSON (deprecated: use --output json)

streb uninstall

Remove Claude Code, Beads, and project artifacts. Use --keep-* flags to preserve specific components.

-y, --yesSkip confirmation prompts

--dry-runPreview what would be removed without executing

--keep-claudePreserve Claude Code CLI

--keep-beadsPreserve Beads CLI

--keep-bduiPreserve Beads UI

--keep-pluginsPreserve Claude plugins

--keep-projectPreserve project files (.beads/, .claude/, CLAUDE.md)

--keep-configPreserve global config (~/.claude/)

--jsonOutput uninstall result as JSON (deprecated: use --output json)

streb version

Show streb version and build information.

--shortPrint only the version number (e.g. 0.7.18)

--jsonOutput version info as JSON (deprecated: use --output json)

streb config

Configuration management.

streb config show

Show detected project configuration.

Supports --output json

streb config set <key> <value>

Set config override — placeholder, not yet implemented

streb config pull <ref>

Pull config from registry reference — placeholder, not yet implemented

streb config push

Publish current config — placeholder, not yet implemented

streb logs

Show recent session logs.

--output json Output as JSON (returns not_implemented stub)

Note: returns a not-implemented error without --output json

streb audit

Audit trail management. Reads the tool-audit.jsonl file written by post-command hooks.

streb audit show

Show audit entries — placeholder, not yet implemented

streb audit export

Export audit data — placeholder, not yet implemented

streb audit tail

Stream live audit events — placeholder, not yet implemented

Supports --output json on all subcommands (returns stubs)

streb req

Requirements management. Operates on the JSONL requirements graph maintained by streb hooks.

streb req import

Import requirements from a source document — placeholder, not yet implemented

streb req link

Link requirements to Beads tasks — placeholder, not yet implemented

streb req trace

Show end-to-end traceability graph — placeholder, not yet implemented

streb req coverage

Show requirements coverage report — placeholder, not yet implemented

Supports --output json on all subcommands (returns stubs)

streb completion [shell]

Generate shell completion scripts. Supported shells: bash, zsh, fish, powershell.

# Add zsh completions

streb completion zsh > ~/.zsh/completions/_streb

# Add bash completions

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