vibe-switch

# 🔄 Vibe-Switch

[![npm version](https://img.shields.io/npm/v/vibe-switch.svg)](https://www.npmjs.com/package/vibe-switch)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)

> **tmux for AI Agents** — Orchestrate multiple AI coding agents in parallel with one command.
>
> 🤖 **AI Agents**: If you are an AI coding assistant, see [docs/ai-skill.md](./docs/ai-skill.md) for the machine-readable command reference and orchestration guide.

[繁體中文](./README.zh-TW.md) | [简体中文](./README.zh-CN.md) | [日本語](./README.ja.md) | English

## Why Vibe-Switch?

Whether you are running commands yourself or letting an AI orchestrator dispatch agents on your behalf, managing multiple AI agents is a cognitive nightmare. If you are a developer using Claude Code, Codex, and Gemini CLI simultaneously, you often face:

- **Terminal Overload:** Dozens of open windows for different tasks.
- **Context Loss:** Manually copying files and diffs between agents to "hand off" work.
- **Process Chaos:** Forgetting which agent is working on which branch or how to stop them all.

**Vibe-Switch** provides a unified CLI to orchestrate multiple agents in isolated environments with seamless context handoff.

## Install

```bash
npm install -g vibe-switch
```

Or install from source:

```bash
git clone https://github.com/brianjhang/vibe-switch.git
cd vibe-switch
npm install
npm run build
npm link
```

> 💡 After installing, the CLI command is **`vibe`** (not `vibe-switch`). Both `vibe` and `vibe-switch` work, but all examples use `vibe` for brevity.

## Quick Start

### 1. Run Multiple Agents

Start different tasks with different agents in one line:

```bash
# Backend task with Gemini
vibe run "Implement JWT authentication middleware" --agent gemini

# Frontend task with Codex
vibe run "Build a responsive login page with React" --agent codex
```

### 2. Check S