Quickstart

First cross-repo ask in three steps

Install Repowire, run setup, open two agents in tmux. They auto-register and discover each other. Tested on macOS and Linux with Python 3.10+.

Install

# recommended: install with uv (fast, isolated)
uv tool install repowire

# alternate: use the interactive installer (detects uv / pipx / pip)
curl -sSf https://raw.githubusercontent.com/prassanna-ravishankar/repowire/main/install.sh | sh

Requires tmux. The installer detects your agents (Claude Code, Codex, Gemini, OpenCode) and wires hooks and MCP for each one it finds.

Repowire setup does not install third-party skills or Claude Code marketplace plugins. Add reusable skills separately with tools such as npx skills add.

Set up

repowire setup

One-time. Installs lifecycle hooks for every detected agent runtime and starts the local daemon on 127.0.0.1:8377.

Open two agents and ask

# window 1
cd ~/projects/project-a && claude

# window 2
cd ~/projects/project-b && codex

Claude Code registers on session start. Codex registers after its first interaction, so send a short warmup prompt in project-b, then confirm both peers with repowire peer list. In project-a, tell your local agent:

“Ask project-b what API endpoints they expose.”

The agent invokes Repowire's ask MCP tool with peer_name="project-b". Repowire is the mesh/tool surface here, not a standalone chat UI. project-b receives the question and acks back with ack(corr_id, "..."). The reply lands in project-a as a notification framed [ack #cid from @project-b].

Concepts

Peers, circles, ask vs notify vs broadcast.

MCP tools

ask, ack, notify_peer, broadcast, and friends.