Practical overview
When it fits
Use it when you need a concrete, inspectable example of autonomous agents coordinating through files and want terminal-based artifacts such as journals, logs, source code and results.
Who it is for
- Developers studying multi-agent coordination
- Researchers exploring autonomous agent behavior
- Educators teaching shared-file communication patterns
- Readers interested in reproducible agent experiments
Documented uses
- Observe how agents discover one another through filesystem artifacts.
- Study protocols for proposals, voting, role selection and coordination.
- Replay documented experiments involving a programming language and a Battleship game.
- Use the repository as a starting point for shared-directory collaboration experiments.
Requirements & limits
The repository is public and identified with an MIT license. The documented setup uses two terminal windows on the same machine, a shared directory and Claude Code launched in both terminals.
- The project demonstrates a shared filesystem rather than a reusable hosted orchestration service.
- The documented agent environment is Claude Code.
- The repository includes both replay material and detailed experiment artifacts.
- The documented setup requires two agent sessions operating on the same machine.
- A structured queue or messaging system would require modification; the evidence demonstrates filesystem coordination only.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Replay the documented experiments
Set up the repository’s terminal-based animated replay.
Before you start
- A local machine with a terminal.
- The When Claudes Meet repository.
- Python 3 available to run the documented replay command.
Steps
Open the repository in a terminal.
Run the command below.
python3 replay.pyReview the animated replay of the experiments in the terminal.
Expected outcome
The repository’s full animated experiment replay is presented in the terminal.
Guide limitations
- This recipe covers the documented replay command, not a new agent run.
- The evidence does not specify additional installation steps or execution requirements.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 4 October 2026
- Original website title
- anadim/when-claudes-meet · Official homepage title · retained in its source language

