Overview

Baag is a streamlined terminal application designed for efficient management of multiple AI coding agents within a single project. By utilizing separate isolated workspaces, Baag enhances productivity while allowing users to harness the capabilities of leading coding agents such as Claude Code, Gemini, and Codex.

Key Features

• Workspace Management: Easily create and manage isolated workspaces for different features or bug fixes in your project.
• AI Agent Integration: Choose from several AI coding assistants to tailor support based on project needs.
• User-Friendly Configuration: Customize preferences for coding environments, AI agents, and target branches through an interactive setup.

Usage

Baag provides a suite of commands designed to simplify development workflows.

Common Commands

# Start a new feature branch 
baag start feature-auth

# List all current workspaces 
baag list

# Push changes and create a pull request 
baag submit

# Submit changes with a customized pull request title 
baag submit --title "Add user authentication system"

# Remove a workspace 
baag stop feature-auth

# Configure personal preferences 
baag config

# Display current configuration settings 
baag config --show

Advanced Submission Options

The submit command offers additional flexibility:

# Create a pull request with custom title and target branch 
baag submit --title "Hotfix: Fix login bug" --base-branch main

# Push changes without creating a PR 
baag submit --no-pr

# Skip git hooks during push 
baag submit --no-verify

Configuration

Baag allows for an individualized experience via a straightforward configuration process:

# Run interactive configuration for setting preferences 
baag config

The configuration options include:

• Base Branch: The default branch for new worktrees (e.g., main, develop)
• AI Agent: Select your preferred AI assistant (claude, copilot, openai)
• Code Editor: Set your default code editor (cursor, code)

Configurations are saved in a .baag/config.json file and are automatically applied to new workspaces.

Directory Structure

Baag organizes workspaces within a .baag directory inside your project, ensuring a clean and structured environment:

my-project/
├── .git/
├── .baag/
│   ├── feature-auth/      # Worktree for auth feature
│   └── bug-fix-login/     # Worktree for bug fix
├── src/
└── ...

Requirements

To run Baag, ensure the following dependencies are installed:

• Git and GitHub CLI (gh)
• Node.