phone-a-friend

phone-a-friend is a CLI orchestration layer for AI coding agents. Relay tasks to any backend, spin up multi-model teams, or run persistent multi-agent sessions with a live web dashboard.

Mode	What it does	Best for
Relay	One-shot delegation to Codex, Gemini, Ollama, Claude, or OpenCode	Quick second opinions, code reviews, analysis
Team	Iterative multi-backend refinement over N rounds	Collaborative review, converging on a solution
Agentic	Persistent multi-agent sessions with @mention routing	Autonomous collaboration, adversarial review, deep analysis

Host parity

Feature	Claude Code	OpenCode
/phone-a-friend (single-backend relay)	✓	✓
/curiosity-engine (Q&A rally)	✓	✓
/phone-a-team (iterative multi-model team)	✓	—
Plugin marketplace install	✓	—
CLI plugin install (phone-a-friend plugin install --<host>)	✓	✓
Skill auto-discovery	✓	✓

OpenCode users can replicate /phone-a-team by running repeated /phone-a-friend calls and synthesizing manually.

Quick Start

Prerequisites: Node.js 22.13+ and at least one backend:

• Claude Code
• Codex CLI
• Gemini CLI
• Ollama
• OpenCode

Install:

npm install -g @freibergergarcia/phone-a-friend
phone-a-friend    # first run shows a guided menu — choose Setup

The setup wizard detects your backends, offers to install detected host integrations, and verifies everything works.

Claude Code marketplace (commands and skills only):

/plugin marketplace add freibergergarcia/phone-a-friend
/plugin install phone-a-friend@phone-a-friend-marketplace

To update: /plugin marketplace update phone-a-friend-marketplace then /plugin update phone-a-friend@phone-a-friend-marketplace.

[!NOTE] Marketplace install ships only the slash commands and skills. For the full CLI (agentic mode, TUI, web dashboard), install via npm install -g @freibergergarcia/phone-a-friend.

OpenCode commands and skills:

If you use OpenCode, install the same Phone-a-Friend skills plus thin slash-command shims into your OpenCode config:

phone-a-friend plugin install --opencode

This installs to ~/.config/opencode/skills/ and ~/.config/opencode/commands/ (or $XDG_CONFIG_HOME/opencode/...). From OpenCode, ask naturally, for example:

Ask Codex through phone-a-friend for a short sanity review of this repo; do not edit files.

From source:

git clone https://github.com/freibergergarcia/phone-a-friend.git
cd phone-a-friend
npm install && npm run build
./dist/index.js   # first run guides you through setup

Then from Claude Code or OpenCode, just talk naturally — the host integration loads the skills automatically:

Ask Gemini to review the error handling in relay.ts

Spin up Codex and Gemini to review the docs.
Then spin another agent to review their reviews and report back.

Build a team with Claude and Ollama. Have them review the website copy,
loop through 3 rounds, and converge on final suggestions.

No slash commands needed once the host integration is installed (see Host parity for which slash commands work in which host).

[!TIP] Claude Code power-user setup: Run in tmux with bypass permissions (⏵⏵) and Agent Teams to watch agents work in parallel split panes. Pair with phone-a-friend agentic mode for fully autonomous sessions.

CLI Usage

Relay