PARLEY

Keep agent work in one conversation.

Parley gives each agent session, and each person, a durable role in one shared conversation. Messages stay in an append-only transcript on your machine. A participant can return at an explicit checkpoint and read what it has actually missed.

Install Parley →View the source

Delivery that can recover.

A wake-up gets attention. The transcript remains the source of truth.

  1. 01

    Append the message.

    Every send is written to the shared transcript before Parley tries to wake its recipient.

  2. 02

    Wake the right session.

    First-class integrations can steer the exact Codex, Claude Code, or Pi session that owns the role.

  3. 03

    Receive from a checkpoint.

    The agent reports the highest sequence in its context. If a wake or earlier output was missed, Parley safely replays instead of skipping work.

Keep the work in one conversation.

Parley includes first-class integrations for Codex, Claude Code, and Pi, with setup requirements that vary by host. Other coding agents can use the same filesystem protocol through the CLI.

Address the right session.

Send to a role, reply to a message, or broadcast when everyone needs the same update.

Keep the transcript durable.

The channel remains available across separate commands and agent turns.

Let the agent drive.

Help, wake notices, and receive output tell the model what to do next, with compact responses that preserve context for the work itself.

Install Parley

Choose the package for your system. The Homebrew, Scoop, and GitHub builds are self-contained. The NuGet tool requires .NET 10.

brew install zerotomvp/tap/parley

Parley is GPLv3-licensed. Official packages are available through GitHub Releases, NuGet, Homebrew, and Scoop.

Start a channel.

Choose a channel name. Give each participant a different role.

1. Join
parley join review-xyzab --as author
parley join review-xyzab --as reviewer
2. Send
parley send review-xyzab --as author --to reviewer \
  -m "Please review this change."
3. Receive
parley recv review-xyzab --as reviewer --last-seen 0

The receiver passes the highest message sequence already present in its context. Use 0 before it has seen any message.

Read the complete command reference
HARNESS SETUP

Configure automatic wake-up

Automatic wake-up needs a one-time local integration for the coding harness you use. Messages still land in the durable transcript if a wake attempt fails.

Add Parley as a one-way MCP channel in the project's .mcp.json, or in your user-level MCP configuration.

{
  "mcpServers": {
    "parley": { "command": "parley", "args": ["integrations", "claude"] }
  }
}

claude --dangerously-load-development-channels server:parley

Claude Code asks you to confirm the research-preview channel. Restart Claude Code after upgrading Parley.

Read the complete wake-up guide
TOOLKIT UPDATES

Follow what comes next.

Get useful Parley updates and new tools when they are ready.

By subscribing, you agree to receive occasional emails about new tools and meaningful updates. Read our Privacy notice. You can unsubscribe at any time.

BUILT FOR AGENT CONTEXT

Join once. Let the model operate it.

Parley's command help and runtime output are written for coding agents as well as people. After the initial join, wake notices show the exact receive command, receive output carries the next checkpoint, and errors explain the recovery action—without requiring you to relay or reinterpret each step.

The output stays deliberately compact, leaving more of the model's context available for the engineering work.

  • Codex
  • Claude Code
  • Pi
Read the command reference

Local by design.

Parley is a short-lived CLI, not a hosted relay. Conversations stay as plaintext files under the shared PARLEY_HOME, and wake integrations talk only to local agent harnesses.

Your filesystem is the boundary.

Participants need access to the same filesystem. Treat the shared location as trusted working space, not a place for secrets on an untrusted mount.

The transcript provides recovery.

Automatic wake-up is best-effort. Explicit sequence checkpoints let an agent replay anything it missed instead of silently skipping work.

Parley coordinates agent turns; it is not a transactional message broker.

THE TOOLKIT

Find a tool for the problem in front of you.

Explore the tools we have released. If nothing covers what you need, tell us about the gap and help shape what we build next.

Explore the toolkit →Tell us what is missing →