Gba

GBA (Geektime Bootcamp Agent)

[](https://github.com/tyrchen/gba/actions)

GBA is a CLI tool that wraps the Claude Agent SDK to help developers plan and implement features through structured, AI-assisted workflows.

Features

• Interactive Planning: Plan features through a TUI chat interface with Claude
• Automated Execution: Execute planned features with automatic phase progression
• Resume Support: Continue from interruptions with automatic checkpoint detection
• Code Review: Integrated AI-powered code review before PR creation
• Verification: Automated verification against acceptance criteria
• Git Integration: Automatic worktree creation, commits, and PR generation

Installation

# Build from source
cargo install --path apps/gba-cli

# Or build in development mode
cargo build --release -p gba-cli

Prerequisites

• Rust 1.85+ (2024 edition)
• Git
• Claude Code CLI installed and configured
• GitHub CLI (gh) for PR creation

Quick Start

1. Initialize a Repository

cd your-project
gba init

This creates:

• .gba/ - GBA metadata directory
• .trees/ - Git worktrees (gitignored)
• .gba.md - Repository documentation for AI context

2. Plan a Feature

gba plan add-user-auth

Opens an interactive TUI where you can:

• Discuss feature requirements with Claude
• Review and refine the implementation plan
• Generate design specs and verification criteria

3. Execute the Plan

gba run add-user-auth

GBA executes a sophisticated pipeline with TUI progress display:

1. Phase Execution - Execute each phase from the design spec with real-time progress
2. Auto-Commit - Commit changes after each phase completes
3. Code Review Loop - AI-powered code review with up to 3 fix iterations
4. Verification Loop - Verify against acceptance criteria wit