Metadata-Version: 2.5
Name: let-them-talk
Version: 0.3.0
Summary: A visual board for your Claude Code agents: see sessions, subagents and background agents as cards, and draw arrows so they talk to each other.
Project-URL: Homepage, https://github.com/abdullahkavakli/let-them-talk
Project-URL: Issues, https://github.com/abdullahkavakli/let-them-talk/issues
Project-URL: Documentation, https://github.com/abdullahkavakli/let-them-talk/blob/main/docs/usage.md
Author: Abdullah KAVAKLI
License-Expression: Apache-2.0
License-File: LICENSE
License-File: mods/let-them-talk-handoff/skills/handoff/LICENSE
License-File: static/fonts/LICENSE-Selawik.txt
Keywords: agents,board,claude,claude-code,dashboard,multi-agent,subagents
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# Let Them Talk

[![Latest release](https://img.shields.io/github/v/release/abdullahkavakli/let-them-talk)](https://github.com/abdullahkavakli/let-them-talk/releases/latest)

A visual board for your agents. Each running Claude Code session is a card, and an arrow from one card to another tells both chats who they work with and why.

![Let Them Talk: cards for Claude Code chats, an arrow between two of them, and their conversation](https://raw.githubusercontent.com/abdullahkavakli/let-them-talk/main/docs/demo/demo.gif)

## What it does

- Draw an arrow between two chats and it tells them who to talk to and why. They then talk through Claude Code's own messaging.
- Click an arrow to read what the two chats sent each other.
- Start a team: a master and up to 8 agents, each with its own role, prompt, model and effort.
- Terminal chats, Cursor chats and background agents share one board, with the subagents they run.
- Local and small: the server is one Python file that uses only Python's standard library. The Claude Code plugin is optional: `uvx let-them-talk` works without it.

## Use cases

- You want your agents to communicate with each other.
- Your Claude CLI (or extension) sessions need to be aware of one another and exchange messages.
- You're working on a project where you need to stay on top of everything (not necessarily code-related).

## Start

Needs Python 3.12+ and Claude Code (on Windows, both inside WSL).

- From Claude Code: install the plugin once, then type `/let-them-talk` in any chat. It starts the board and opens it in your browser (it needs [uv](https://docs.astral.sh/uv/)), and the board keeps running after that chat ends. The plugin also shows each chat's suggested next prompt on the board ([more](https://github.com/abdullahkavakli/let-them-talk/blob/main/docs/configuration.md#claude-code-plugin)).

  ```
  claude plugin marketplace add abdullahkavakli/let-them-talk
  claude plugin install let-them-talk@let-them-talk
  ```

- One line, without the plugin: `uvx let-them-talk` (needs [uv](https://docs.astral.sh/uv/); or `pipx run let-them-talk`). It starts the board and opens it in your browser; `--no-open` skips that. Its boards are kept in `~/.local/share/let-them-talk`, whichever way you start it.
- From a copy of this repository, on Windows: double-click `Start Let Them Talk.bat`.
- From a copy of this repository, on macOS, Linux or WSL: `./start.sh`, then open <http://localhost:8765>.

Click **New board** and pick a project folder: its running chats appear as cards. Drag the blue handle from one card onto another, then click **Connect**.

More: [using it](https://github.com/abdullahkavakli/let-them-talk/blob/main/docs/usage.md) · [how it works](https://github.com/abdullahkavakli/let-them-talk/blob/main/docs/how-it-works.md) · [settings](https://github.com/abdullahkavakli/let-them-talk/blob/main/docs/configuration.md) · [limits](https://github.com/abdullahkavakli/let-them-talk/blob/main/docs/limits.md)

Not related to [Dekelelz/let-them-talk](https://github.com/Dekelelz/let-them-talk), a different project with the same name.

## License

[Apache 2.0](https://github.com/abdullahkavakli/let-them-talk/blob/main/LICENSE). The Selawik font and the `/handoff` skill keep their own licenses, next to their files.
