avirtual

Wb Wrap — AI skill for Claude Code

AI community

CLI inter-process communication wrapper for AI agents (Claude, Codex).

How to install Wb Wrap

This entry records only its repository, not the path inside it, so there is no exact command to give. Open avirtual/wb-wrap and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Wb Wrap does

CLI inter-process communication wrapper for AI agents (Claude, Codex).

Alternatives in AI

Pro Workflow — 1,400+ Battle-tested Claude Code workflows from power users 1.4k ★
Video Wrapper Skills — 为访谈视频添加综艺风格视觉特效的 Claude Skill 284 ★
Gem Team — Turn AI coding into an engineering process 210 ★

README

wb-wrap

CLI inter-process communication wrapper for AI agents. Lets Claude Code and Codex CLI instances talk to each other.

Install

Download a binary from [Releases](https://github.com/avirtual/wb-wrap/releases) and put it on your PATH:

cp wb-wrap-darwin-arm64 ~/bin/wb-wrap
chmod +x ~/bin/wb-wrap

Or build from source:

go install github.com/avirtual/wb-wrap@latest

Usage

# Wrap Claude (default)
wb-wrap --name alice

# Wrap Codex
wb-wrap --name bob --cli codex

# With extra CLI args
wb-wrap --name alice --resume abc123
wb-wrap --name bob --cli codex --model o3

# See who's online
wb-wrap who

# Send a message from outside
wb-wrap send alice "check the API changes"

How it works

wb-wrap spawns your CLI in a PTY and adds an IPC layer:

Registry: Each wrapper registers in /tmp/wb-wrap/ with a Unix socket
Messaging: Wrappers communicate via Unix domain sockets (JSON, max 64KB)
Intent protocol: Agents use [cli:dm TARGET] message in their output to send messages
JSONL tailing: For Claude/Codex, reads the transcript for intents (more reliable than PTY scanning)
Injection: Incoming messages are injected into the child's stdin (Ctrl-U, text, Enter)

Protocol

Agents write these intents as plain text in their responses:

[cli:dm TARGET] message body     Send a direct message
[cli:who]                        List online peers
[cli:broadcast] message body     Send to all peers
[cli:name]                       Query own wrapper name

Incoming messages appear as:

[from SENDER] message body
[broadcast from SENDER] message body

Example: Claude and Codex talking across workspaces

**Terminal 1** — Codex wrapping an API workspace:

$ wb-wrap --cli codex --name codex
╭────────────────────────────────────────────────────╮
│ >_ OpenAI Codex (v0.118.0)                         │
│ model:     gpt-5.3-codex medium   /model to change │
╰──────────────────────────────────────────