Remote Collaboration
dual-agent-development 2.3.0 introduces the first production release of
cross-process Remote Collaboration.
Two agent runtimes can now collaborate through a packet-based,
runtime-neutral boundary without coupling the collaboration protocol
to a specific agent provider.
What you can do
- Connect two agent runtimes across a real process boundary.
- Exchange typed collaboration packets through a runtime-neutral envelope.
- Preserve task and correlation identity across the remote boundary.
- Use a composition root to construct remote sessions from agent declarations.
- Run a real Claude Code collaboration example.
- Keep local and remote execution concerns separated from transport.
Quick start
The repository contains two focused examples:
examples/remote_offline_demo.py— deterministic offline demonstration.examples/remote_real_claude.py— REAL Claude Code collaboration.
The examples are repository examples and are intentionally not part of the
installed Python package.
Offline vs REAL
The offline example uses a deterministic scripted agent and requires no
provider credentials.
The REAL Claude example invokes the local Claude Code CLI and therefore
requires Claude Code to be installed and authenticated.
A missing REAL prerequisite fails explicitly; it never silently falls back
to the offline implementation.
Architecture
The remote collaboration path is intentionally layered:
Agent declaration → Remote composition (build_remote_session) →
RemoteAgentSession → subprocess stdio envelope transport →
child-process endpoint → agent adapter
Transport, session, endpoint, and runtime execution remain separate
responsibilities.
Current boundary
2.3.0 provides cross-process remote collaboration.
It does not provide:
- cross-machine networking
- agent authentication or authorization
- cancellation semantics
- retry/reconnect
- global capability-based agent selection
- distributed multi-agent scheduling
- agent network / marketplace
- dashboard or hosted service
Those are intentionally outside this release.
Installation
pip install dual-agent-development==2.3.0Python 3.10+ is supported.
Documentation
See the README for the Remote Collaboration quick start, architecture,
examples, and common failure guidance.