AI Developer Environment Bootstrap
Get your Agentic Dev environment ready in seconds
One command installs Claude Code CLI, Beads issue tracker, and configures your API key. Skip the setup docs. Start coding.
brew tap StefanTrockel/streb && brew install streb
The Claude Code ecosystem moves fast. New tools, better configurations, emerging best practices — keeping up takes hours you don't have.
streb init
Done.
What gets installed
streb sets up these essential tools for AI-assisted development.
Claude Code
Anthropic's agentic coding assistant. Chat with Claude directly in your terminal.
code.claude.com/docsBeads CLI
Git-backed issue tracker with dependency management. Issues live in your repo.
github.com/steveyegge/beadsBeads UI
Visual dashboard for Beads. Browse issues, manage dependencies, track progress.
github.com/mantoni/beads-uiNo licenses required
All tools are open source. You only need an adesso AI-Hub API key to get started.
Get the most out of Claude Code
streb installs production-ready templates that configure Claude Code with best practices, security rules, and productivity commands.
/commit
Create conventional commits with proper formatting
/pr
Generate pull requests with summary and test plan
/next
Find and claim the next available task
/done
Complete work: test, commit, close task, sync
/review
Review code for quality and security issues
Checks correctness, security, performance, and maintainability with severity ratings
Generates tests using AAA pattern with happy path, edge cases, and error handling
Improves code clarity and structure while preserving behavior
Logs all tool calls before execution for audit trail and debugging
Auto-loads Beads context on start, syncs state on stop
Commit-msg hook enforces conventional commit format
Native issue tracking integration. Use /next, /done directly in Claude
Context management for long sessions. Maintains conversation state across compaction
Built-in Safety Rules
Everything you need to get started
streb automates the complete Claude Code setup process, from CLI installation to project configuration.
Claude Code CLI
Installs Claude Code via official installer. macOS, Linux, and Windows supported.
Beads Issue Tracker
Installs bd CLI and Beads UI. Git-backed issues with dependency tracking.
API Key Setup
Interactively configures the API key for Claude Code. Supports adesso AI Hub and Anthropic hosted Claude models.
Jira Integration
Optionally configures Jira for syncing issues between Beads and Jira projects. Including OAuth setup.
Resume on Failure
Checkpoint system saves progress. Resume interrupted installs with --resume.
Doctor & Auto-fix
Run streb doctor to diagnose issues. Auto-fix common problems.
Frequently Asked Questions
Common questions about installing and deploying streb in your organization.
Installation is just the beginning. The real time investment is learning and configuring all the features:
- Claude Code features: Discovering slash commands (/commit, /pr, /next, /done), understanding hooks, configuring sub-agents, writing CLAUDE.md rules
- Sub-agent prompts: Writing effective prompts for code-reviewer, test-writer, refactorer agents — requires understanding what makes a good prompt
- Beads workflow: Learning commands (bd ready, bd update, bd close, bd sync), understanding dependencies, setting up Jira OAuth
- Best practices: Git safety rules, security configurations, session management, logging for audit trails
Realistic manual setup: 8-16 hours spread over days or weeks to become fully productive with all features.
With streb: under 5 minutes. You get production-ready configurations with:
- Pre-written slash commands that follow best practices
- Specialized sub-agents with carefully crafted prompts
- Hooks for logging, session management, and git integration
- Security rules and git safety already configured
- Beads workflow ready with Jira sync
For a team of 10 developers, that's 80-160 hours saved — plus the value of consistent, battle-tested configurations across the team.
No admin/root required for core functionality. streb installs to user directories and npm packages install globally to user-controlled paths.
Admin may be needed for:
- Windows: UAC prompts may appear for winget/scoop/choco
- macOS: Homebrew typically runs without sudo
Prerequisites: Git (with user.name/email configured), npm, 500MB free disk space, write access to home directory.
System modifications:
- Creates
~/.claude/and~/.streb/directories (user config only) - May modify shell profiles (.bashrc, .zshrc) for PATH/env vars
- Does NOT modify system registry or global settings
- Local services bind to 127.0.0.1 only (not network-exposed)
Credential storage:
- API keys stored in
~/.claude/settings.json(file permissions 0600) - Jira tokens in
~/.config/streb/jira-credentials.json - File-based storage, no system keychain integration
Security: All tools are open source. streb itself is internal adesso tooling.
Yes, streb supports enterprise preconfiguration via environment variables:
Golden image strategy:
- Pre-install prerequisites (git, npm)
- Set environment variables in
/etc/environmentor system profile - Optionally run
streb init --yesto create base config - Deploy image to VDIs
Silent deployment: streb init --yes --config-strategy backup
Required outbound HTTPS (port 443):
| Domain | Purpose |
|---|---|
| claude.ai | Claude Code installation |
| raw.githubusercontent.com | Beads installation script |
| registry.npmjs.org | npm packages |
| github.com | Git operations, releases |
Optional (based on features):
auth.atlassian.com— Jira OAuth (if using Jira sync)adesso-ai-hub.3asabc.de— adesso AI Hub gateway- Corporate GitLab instance — source control integration
Proxy support: streb respects HTTP_PROXY and HTTPS_PROXY environment variables.
No software licenses required. All installed tools are open source:
- Claude Code — Free CLI from Anthropic
- Beads CLI — MIT license
- Beads UI — MIT license
You only need: An adesso AI-Hub API key (or direct Anthropic API key) to use Claude Code.
Update streb itself:
Update installed tools:
Run streb status to see current versions of all installed components.
streb is idempotent — it detects existing installations and skips them automatically.
- Already have Claude Code? streb skips installation, just configures templates
- Already have Beads? streb skips installation, initializes project if needed
- Existing configs? Use
--config-strategyto merge, backup, or skip
Running streb init multiple times is safe and produces the same result. Use --dry-run to preview what would happen without making changes.
streb itself does not collect or transmit any telemetry. It only makes network requests to download tools during installation.
The installed tools have their own data policies:
- Claude Code: Sends prompts to Anthropic API (or adesso AI Hub). Code context is sent to generate responses. See Anthropic's privacy policy.
- Beads: Stores issues locally in your git repo. No external transmission unless you sync to a remote git server.
- Jira sync: Only activated if you configure it. Sends issue data to your Jira instance.
For adesso users: Using adesso AI Hub keeps API traffic within adesso infrastructure rather than direct to Anthropic.
Skills Reference
Complete reference of all Claude Code slash commands, workflows, and Beads operations available through streb templates.
Atomic, single-purpose operations that complete quickly
Structured workflows with quality gates (GEV pattern)
Complex autonomous workflows with iteration loops
Git-backed issue tracking and task management
| Command | Description | Category | ||
|---|---|---|---|---|
| Loading skills... | ||||
0 skills available
CLI Reference
Complete reference of all streb CLI commands and their available flags.
Global Flags
Available on all commands
-v, --verbose
Enable verbose output
--no-color
Disable colored output
--no-interactive
Disable interactive prompts
streb init
Initialize Claude Code and Beads in your project
-y, --yes
Accept defaults, non-interactive
--config-strategy
Config handling: merge, backup, skip, overwrite
--skip-claude
Skip Claude Code installation
--skip-beads
Skip Beads CLI installation
--skip-bdui
Skip Beads UI installation
--skip-templates
Skip template copying
--skip-plugins
Skip plugin installation
--skip-jira
Skip Jira integration setup
--jira-url
Jira project URL for non-interactive setup
--dry-run
Show what would be done without executing
--json
Output results as JSON
--resume
Auto-resume from checkpoint without prompting
--fresh
Ignore checkpoint, start fresh
streb update
Update bundled tools (Claude Code, Beads CLI, Beads UI)
--claude
Update Claude Code only
--beads
Update Beads CLI only
--bdui
Update Beads UI only
--check
Check for updates without installing
--json
Output results as JSON
streb upgrade
Upgrade streb itself to the latest version
--check
Check for updates without installing
--force
Force reinstall even if up-to-date
--json
Output results as JSON
streb doctor
Check environment health
--json
Output results as JSON
--fix
Attempt to fix issues automatically
streb status
Show environment status
--json
Output results as JSON
streb uninstall
Uninstall Claude Code and Beads from your system
-y, --yes
Skip confirmation prompts
--dry-run
Show what would be done without executing
--keep-claude
Preserve Claude Code CLI
--keep-beads
Preserve Beads CLI
--keep-bdui
Preserve Beads UI
--keep-plugins
Preserve Claude plugins
--keep-project
Preserve project directories (.beads/, .claude/)
--keep-config
Preserve global config (~/.claude/)
streb version
Show version information
No additional flags
streb completion [shell]
Generate shell completion script
Supported shells: bash, zsh, fish, powershell