For Developers

Per-project configuration

Commit a .streb/config.yaml file to your repository to share project settings with your team. The minimum useful config sets the project name:

project:
  name: my-project

streb merges this with the user's global config (~/.streb/config.yaml) and any environment variables. The full config schema is documented in the Reference.

Note

Never commit API keys or tokens. They belong in .streb/session (device-encrypted) or environment variables. Add .streb/session to your .gitignore.

Environment variables and flags

Commonly used environment variables:

Variable	Purpose
`STREB_AIHUB_KEY`	adesso AI Hub API key (highest auth priority)
`ANTHROPIC_AUTH_TOKEN`	Alternate name for the AI Hub key
`ANTHROPIC_API_KEY`	Direct Anthropic API key

Global flags (apply to every command):

Flag	Description
`-v`, `--verbose`	Set log level to debug
`-q`, `--quiet`	Set log level to error (suppress info output)
`--log-level <level>`	One of: debug, info, warn, error
`--version`	Print version and exit
`-h`, `--help`	Show usage

Scripting and CI

streb detects whether stdout is a TTY. In non-TTY contexts (CI, scripts, pipes), it automatically uses plain-text output — no interactive prompts, no color codes, no Bubble Tea UI.

# CI pipeline example
STREB_AIHUB_KEY=${{ secrets.STREB_AIHUB_KEY }} \
  streb init

# Check exit code
if streb doctor; then
  echo "Environment ready"
fi

Note

streb init returns exit code 130 on Ctrl+C/SIGTERM. Non-zero exit codes indicate a failure. Use --quiet to suppress progress output in scripts.

Print the installed version for pinning in CI:

streb version
# v1.0.0

Troubleshooting

streb doctor shows failures

Run streb doctor to get the current status of all prerequisites. It reports which tools are missing and what to do.

Session file invalidated after hardware change

If you see "device fingerprint has changed", your encrypted session is no longer readable. Re-run streb init to re-authenticate and create a new session.

Proxy not detected

If your environment uses an HTTP proxy, ensure HTTP_PROXY or HTTPS_PROXY is set. streb reports proxy configuration as part of the doctor check.