@agfpd/spawned-peer
v0.3.16
Published
IAPeer lifecycle primitive for ephemeral peers. MCP tool spawn(personality, runtime?, task, work_dir?) brings up a short-lived dedicated Claude or Codex session under IAP identity, autocreates peer infrastructure on first call, idempotent reuse after, aut
Maintainers
Readme
Spawned-Peer
Lifecycle primitive for ephemeral peers under the IAPeer Plugin Contract v1. A spawned peer is brought up for one task with its own cwd, IAP identity, and tmux endpoint, then auto-reaped after one hour of idle. Pair primitive to Persistent-Peer.
A single MCP tool spawn(personality, runtime?, task, work_dir?) autocreates peer infrastructure on first call and reuses it idempotently after. Works on both claude and codex runtimes from MVP.
Install
# Claude Code
claude plugin marketplace add agfpd/agfpd-marketplace
claude plugin install spawned-peer@agfpd --scope project
# Codex
codex plugin marketplace add agfpd/agfpd-marketplace
codex plugin add spawned-peer@agfpdDocumentation
Full plugin reference — tool contract, status flow, autocreate vs reuse, READY gate, lifecycle, boundaries, repo layout: docs/PLUGIN.md.
Runtime package
The MCP server is published on npm as @agfpd/spawned-peer. The plugin's .mcp.json invokes it via npx -y @agfpd/spawned-peer@latest — no local build required for users.
Requires bun ≥ 1.0, tmux, jq on the host. Plus claude and/or codex CLIs for the runtimes you spawn against. The IAP plugin must also be installed (peers index + send_to_peer).
License
Apache-2.0
