Vibe-Switch for Openclaw

Vibe-Switch acts as a tmux-like orchestrator for AI coding agents, allowing you to run multiple LLM-powered tools simultaneously on isolated Git worktrees.

brianjhang
v1.0.2
Apr 11, 2026
0
884
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install vibe-switch

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install vibe-switch using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Vibe-Switch?

Vibe-Switch is a powerful CLI tool designed to solve the bottleneck of sequential AI coding. By leveraging an adapter-based architecture, it allows developers to dispatch complex tasks to multiple agents like Claude Code, Codex, and Gemini simultaneously. This Openclaw Skills compatible orchestrator ensures that each agent operates within its own isolated Git worktree, preventing file conflicts and maintaining a clean development environment.

The core value of Vibe-Switch lies in its ability to manage the lifecycle of these agents. Instead of waiting for one AI to finish before starting the next, you can parallelize your workflow. It also features a unique handoff mechanism, enabling the output and context of one agent to be seamlessly transitioned to another, which is essential for multi-stage development pipelines.

Vibe-Switch Use Cases

  • Dispatching separate frontend and backend tasks to different AI agents at the same time.
  • Running a secure, sandboxed Codex agent for logic implementation while using Claude for architectural review.
  • Transitioning a completed API task from a reasoning agent to a testing agent for automated test generation.
  • Monitoring real-time outputs from multiple AI streams using a unified watch command.

How Vibe-Switch Works

  1. The user initiates a task via the CLI, specifying the agent and the natural language prompt.
  2. Vibe-Switch creates a dedicated Git worktree and branch based on the current HEAD to ensure total isolation.
  3. The selected AI agent is spawned as a subprocess, receiving the task prompt while its logs are captured locally.
  4. Users monitor progress through status dashboards or real-time log streaming.
  5. Upon completion, the developer can merge the worktree changes or hand off the context to another agent for further refinement.
  6. A cleanup command removes temporary worktrees and archived logs once the feature is integrated.

Vibe-Switch Setup

Install the package globally via npm to integrate this into your Openclaw Skills workflow:

npm install -g vibe-switch

Ensure you have the necessary agent binaries installed (e.g., claude, codex, or gemini) and their respective API keys configured in your environment. Run vibe doctor to verify your setup.

Vibe-Switch Data Schema & Taxonomy

Vibe-Switch maintains a local state and organized file structure to manage multi-agent workflows:

Path Description
~/.vibe-switch/tasks.json Central registry of task states, PIDs, and branch mappings.
~/.vibe-switch/logs/ Individual stdout/stderr logs for every spawned agent session.
~/.vibe-switch/snapshots/ Context metadata used for transferring state during handoffs.
.vibeswitch.json Optional project-level configuration for custom agent behaviors.

Vibe-Switch Advanced Features

  • Isolated Git Worktrees: Automatically manages sibling directories to prevent agents from overwriting each other's work.
  • Agent Handoffs: Transfer the branch state and a custom message from one agent to another with a single command.
  • Real-time Multi-streaming: Use the watch command to view live updates from all active agents in a split-view style interface.
  • Environment Diagnosis: Built-in doctor command to check for missing dependencies and agent availability.
  • Modular Adapters: Extensible architecture supporting Claude Code, Codex, Gemini, Antigravity, and OpenClaw agents.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*