repobird-cli

module
v0.1.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 27, 2025 License: AGPL-3.0

README

RepoBird CLI

cli-logo-loading

Go Version CI Status Release

One-Shot Issue to PR with Complete Git Automation

RepoBird CLI is the command-line interface for RepoBird.ai - one-shot coding agents that handle everything from issue to PR. No chat, no iterations, no manual Git operations. Write your issue once, get a perfect PR back. Clear entire backlogs with bulk parallel runs.

🎯 What is RepoBird?

RepoBird provides one-shot coding agents with complete Git automation. Unlike chat-based AI tools that require back-and-forth iterations and manual Git operations, RepoBird is simple: issue in, PR out.

Write your issue description once, and our autonomous agents handle everything - research, implementation, testing, commits, and PR creation. No chat interface, no copy-pasting code, no Git commands. The CLI enables massive scale with bulk parallel runs - clear your entire backlog in one command.

Key Features
  • 🚀 One-Shot Execution: No chat, no iterations - write once, ship automatically
  • 🔧 Complete Git Automation: Never touch Git - perfect commits, branches, and PRs every time
  • ⚡ Bulk Parallel Runs: Clear 50+ issues simultaneously with one command
  • 🤖 Autonomous Agents: Full cycle from research to PR without human intervention
  • 📊 Real-Time Monitoring: Track progress of all parallel runs in the TUI dashboard
  • 🔒 Isolated VM Execution: Each agent runs in its own secure Debian microVM with full development tools
  • 🌐 Complete Dev Environment: Multi-language support, package managers, databases - everything needed to build real software

🎯 Why RepoBird?

The Problem with Other AI Tools
  • IDE-based tools: Run locally with resource constraints, handle one task at a time, require IDE context switching and manual Git operations
  • Other AI Agents: Chat interfaces requiring multiple iterations, manual PR creation, no parallel execution capabilities, lack native GitHub integration
The RepoBird Difference

GitHub-Native Integration: Lives entirely within your GitHub workflow as a GitHub App. Complete automation from issue to PR - no external tools, no context switching.

Cloud-Based Parallel Execution: The ONLY cloud-based solution with true parallel processing. Launch 50 agents simultaneously - each with full resources, no local constraints.

One-Shot Simplicity: Write your issue once, get a production-ready PR back. No chat, no iterations, no manual steps. 73% of PRs merge without changes.

Complete Git Automation: Our agents handle everything - branching, atomic commits with proper messages, comprehensive PR descriptions. You never touch Git.

Unlimited Scale: Submit 100+ tasks in parallel with RepoBird CLI. While you're in a meeting, cloud agents clear your entire backlog. No resource constraints, no queuing.

Enterprise-Grade Environment: Each agent runs in an isolated cloud VM with full development tools, package managers, and internet access. Powered by Claude Code - the industry's most advanced AI coding agent.

📦 Installation

Quick Install (Linux/macOS)
curl -sSL https://raw.githubusercontent.com/RepoBird/repobird-cli/main/scripts/install.sh | bash
Direct Download
macOS
# Apple Silicon
curl -L https://github.com/RepoBird/repobird-cli/releases/latest/download/repobird-cli_darwin_arm64.tar.gz | tar xz && \
sudo mv repobird /usr/local/bin/

# Intel
curl -L https://github.com/RepoBird/repobird-cli/releases/latest/download/repobird-cli_darwin_amd64.tar.gz | tar xz && \
sudo mv repobird /usr/local/bin/
Linux
curl -L https://github.com/RepoBird/repobird-cli/releases/latest/download/repobird-cli_linux_amd64.tar.gz | tar xz && \
sudo mv repobird /usr/local/bin/
Windows

Download the latest ZIP from the releases page and extract repobird.exe.

Build from Source
# Requires Go 1.20+
git clone https://github.com/RepoBird/repobird-cli.git
cd repobird-cli
make build
sudo cp build/repobird /usr/local/bin/

🚀 Quick Start

1. Get Your API Key

Sign up for a free account at RepoBird.ai and get your API key from Dashboard → API Keys.

2. Authenticate
# One-time setup
repobird login
# Enter your API key when prompted
3. Submit Your First Task (One-Shot)
# Quickest way - direct command with flags (no file needed)
repobird run -r your-org/your-repo -p "Fix the login bug where users get stuck on loading screen"

# Or read prompt from a file using @ prefix
echo "Fix the login bug where users get stuck on loading screen" > task.txt
repobird run -r your-org/your-repo -p @task.txt

# Or use a JSON file for more options
echo '{
  "repository": "your-org/your-repo",
  "prompt": "Fix the login bug where users get stuck on loading screen"
}' > fix.json

repobird run fix.json --follow
# That's it. PR will be created automatically. No further action needed.
4. Clear Your Entire Backlog (Bulk Mode)
# Submit multiple issues at once
echo '{
  "repository": "your-org/your-repo",
  "runs": [
    {"prompt": "Fix login bug"},
    {"prompt": "Add dark mode"},
    {"prompt": "Improve error handling"},
    {"prompt": "Update dependencies"},
    {"prompt": "Add unit tests for auth module"}
  ]
}' > backlog.json

# Fire and forget - all PRs created in parallel
repobird bulk backlog.json

# Monitor all runs in real-time
repobird tui

📖 Usage Guide

Authentication Management
repobird login          # Interactive login with API key
repobird verify         # Verify your API key is valid
repobird info           # Show authentication status
repobird logout         # Remove stored credentials

# Alternative: Use environment variable
export REPOBIRD_API_KEY=your-api-key
Submitting Tasks
# Single task
repobird run task.json --follow

# From different formats
repobird run task.yaml          # YAML format
repobird run task.md            # Markdown with frontmatter
cat task.json | repobird run -  # From stdin

# Bulk operations
repobird bulk tasks.json        # Submit multiple tasks
Monitoring & Management
# Check status
repobird status                 # List all runs
repobird status RUN_ID          # Check specific run
repobird status --follow RUN_ID # Live updates

# Interactive dashboard
repobird tui                    # Launch terminal UI
Terminal UI Navigation
tui-example

The interactive dashboard features a Miller column layout inspired by the ranger file manager, providing hierarchical navigation through repositories → runs → details in a three-column view. This intuitive layout allows you to see context at every level while drilling down into specific run details.

Key Action
Tab / → Navigate forward between columns
Shift+Tab / ← Navigate backward
↑ / ↓ Move selection up/down
Enter Select item
f Fuzzy search in current column
n Create new run
r Refresh data
? Show help
q Quit
Example Templates
# Generate example configurations
repobird examples generate minimal -o task.json
repobird examples generate bulk -o bulk.json
repobird examples schema  # View full schema documentation

📝 Task Configuration

Tasks are defined in JSON, YAML, or Markdown files with two required fields:

  • repository - Target repository (format: "owner/repo")
  • prompt - Task description for the AI
Simple Example
{
  "repository": "myorg/webapp",
  "prompt": "Add user authentication with JWT tokens"
}
Advanced Example
{
  "repository": "myorg/webapp",
  "prompt": "Implement OAuth2 authentication",
  "source": "main",
  "target": "feature/oauth",
  "title": "Add OAuth2 support",
  "context": "Use Google and GitHub as providers",
  "files": ["src/auth/", "config/oauth.json"]
}
Bulk Operations

Submit multiple tasks in a single file:

{
  "repository": "myorg/webapp",
  "runs": [
    {"prompt": "Fix login bug", "target": "fix/login"},
    {"prompt": "Add password reset", "target": "feature/reset"},
    {"prompt": "Improve error handling", "target": "fix/errors"}
  ]
}

For complete configuration options and examples, see the Run Configuration Guide.

🛡️ Advanced Features

Smart Caching
  • Local caching reduces API calls and improves performance
  • Repository and run data cached for quick access
  • Automatic cache invalidation on updates
Retry Logic
  • Automatic exponential backoff for transient failures
  • Configurable retry attempts and timeouts
  • Graceful handling of rate limits

📚 Documentation

Getting Started
User Guides
Reference
Development

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup
# Clone your fork
git clone https://github.com/your-username/repobird-cli.git
cd repobird-cli

# Install dependencies
make deps

# Run tests
make test

# Build locally
make build

📄 License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.

🌟 Support

🙏 Acknowledgments

Built with:

Made with ❤️ by the RepoBird team

Directories

Path Synopsis
cmd
repobird command
internal
api
api/dto
bulk
cache
commands
config
container
domain
errors
mock
models
prompts
repository
retry
services
tui
tui/cache
tui/components
Package components provides reusable UI components for the TUI
 Package components provides reusable UI components for the TUI
tui/debug
tui/forms
tui/interfaces
tui/keymap
tui/messages
tui/styles
tui/views
utils
pkg
utils
version
tests
helpers

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.