DEPRECATED

This repo provides Skills and Agents to handle complex tasks across multiple repositories but it had the problem of lacking flexibility and being difficult to customize. For example, While there are parts where precise operations are performed using scripts, the central part requires control over behavior via prompts, which occasionally resulted in strange behavior.

Developing a new tool from scratch that inherits the ideas from this repository: sters/ai-workspace-v2

ai-workspace

A multi-repository workspace manager for Claude Code. This tool provides Claude with skills and sub-agents to handle complex tasks across multiple repositories using git worktrees for isolation.

Web UI

The web UI has been moved to sters/ai-workspace-v2.

# Start the web UI from this directory
bunx github:sters/ai-workspace-v2@latest .

# If you encounter issues, clear the Bun cache first
bun pm cache rm

The web UI has its own prompt management system not depending on this repository's skills and agents. However, it can be effectively utilized as part of the initial setup for ai-workspace such as .claude rules.

Skill + Agent based approach

Prerequisites

The following tools must be installed and available in your PATH:

• git - For repository cloning, worktree management, and version control operations
• gh (GitHub CLI) - For creating and managing pull requests

Installation

# macOS (Homebrew)
brew install git gh

# Authenticate with GitHub
gh auth login

Usage

1. Clone this repo

2. Open with claude command (Claude Code CLI)

3. Initialize a workspace:

   /workspace-init Add user authentication feature to github.com/org/repo
   

   More examples:

   # With Jira ticket
   /workspace-init PROJ-123 Fix login timeout issue in github.com/org/api
   
   # Multiple repositories
   /workspace-init Add product ID to cart API involving github.com/org/proto and github.com/org/api
   
   # Research task
   /workspace-init Investigate performance bottleneck in github.com/org/backend
   

4. Execute the tasks:

   /workspace-execute
   

5. Review and create PR:

   /workspace-review-changes
   /workspace-create-or-update-pr
   

How It Works

Tasks are executed in isolated directories (./workspace/{task-name}-{date}/) using git worktrees. Claude clones the target repository on first use to ./repositories/ and creates worktrees for each task.

Available Skills

Skill	Description
/workspace-init	Create a new workspace with README and TODO files (calls /workspace-add-repo to clone and create worktrees)
/workspace-add-repo	Add a repository to a workspace (clones if needed, creates worktree)
/workspace-execute	Execute TODO items (implements code, runs tests, makes commits)
/workspace-review-changes	Review code changes and generate review reports
/workspace-create-or-update-pr	Create or update pull requests for all repositories (draft by default)
/workspace-update-todo	Add, remove, or modify TODO items
/workspace-show-status	Show TODO progress and background agent status
/workspace-list	List all workspaces
/workspace-show-current	Display the specified workspace path
/workspace-show-history	Show commit history of README/TODO changes
/workspace-delete	Delete a workspace (with confirmation)
/workspace-prune	Delete workspaces not modified within N days

See CLAUDE.md for detailed documentation.

Available Agents

Agents are specialized sub-processes that handle specific tasks autonomously. You don't need to invoke agents directly — skills automatically launch the appropriate agents for you.

Agent	Description	Invoked by
workspace-repo-todo-planner	Analyzes repository and creates detailed TODO items	/workspace-init
workspace-todo-coordinator	Coordinates TODOs across repos for parallel execution	/workspace-init, /workspace-update-todo
workspace-repo-todo-reviewer	Validates TODO items for specificity and actionability	/workspace-init, /workspace-update-todo
workspace-repo-todo-executor	Executes TODO items (implements code, runs tests, commits)	/workspace-execute
workspace-repo-todo-updater	Updates TODO items (add, remove, modify)	/workspace-update-todo
workspace-repo-review-changes	Reviews code changes and generates review report	/workspace-review-changes
workspace-repo-todo-verifier	Verifies TODO items have been completed	/workspace-review-changes
workspace-collect-reviews	Collects review results and creates summary	/workspace-review-changes
workspace-repo-create-or-update-pr	Creates or updates pull request following repo's PR template	/workspace-create-or-update-pr

Skills and Agents Relationship

/workspace-init
  ├─→ workspace-repo-todo-planner (per repository, parallel)
  ├─→ workspace-todo-coordinator
  └─→ workspace-repo-todo-reviewer (per repository, parallel)

/workspace-execute
  └─→ workspace-repo-todo-executor (per repository)

/workspace-update-todo
  ├─→ workspace-repo-todo-updater
  ├─→ workspace-todo-coordinator (if multi-repo)
  └─→ workspace-repo-todo-reviewer

/workspace-review-changes
  ├─→ workspace-repo-review-changes (per repository, parallel)
  ├─→ workspace-repo-todo-verifier (per repository, parallel)
  └─→ workspace-collect-reviews

/workspace-create-or-update-pr
  └─→ workspace-repo-create-or-update-pr (per repository, parallel)

Policies

See .claude/README.md for implementation policies for agents and skills.