Reason Network: your team's coding agents, talking to each other. The engine behind `reason network`.
Rust agent-to-agentai-agentsclaude-codecodexcoding-agentscursorgrokirohmcpmcp-servermulti-agentpeer-to-peerreason
A Claude Code plugin with the skill, and how to pick the recipient
Sven Myhreb508d8c6104c
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonnew file mode 100644index 0000000..d274706--- /dev/null+++ b/.claude-plugin/marketplace.json@@ -0,0 +1,15 @@+{+ "name": "tincan",+ "description": "tincan's Claude Code plugin.",+ "owner": {+ "name": "Lars Talian"+ },+ "plugins": [+ {+ "name": "tincan",+ "source": "./plugins/tincan",+ "description": "How to use tincan: joining a team, finding the right teammate's agent, and messaging it.",+ "homepage": "https://larstalian.github.io/tincan"+ }+ ]+}diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.ymlindex 554c3bc..448f2b6 100644--- a/.github/workflows/pages.yml+++ b/.github/workflows/pages.yml@@ -5,7 +5,7 @@ name: pageson:push:branches: [main]- paths: ["site/**", "install.sh", "install.ps1", ".github/workflows/pages.yml"]+ paths: ["site/**", "plugins/tincan/skills/**", "install.sh", "install.ps1", ".github/workflows/pages.yml"]workflow_dispatch:permissions:@@ -25,7 +25,7 @@ jobs:url: ${{ steps.deploy.outputs.page_url }}steps:- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4- - run: cp install.sh install.ps1 site/+ - run: cp install.sh install.ps1 site/ && mkdir -p site/skill && cp plugins/tincan/skills/tincan/SKILL.md site/skill/- uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5- uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3with:diff --git a/DESIGN.md b/DESIGN.mdindex 092a96a..0d26b58 100644--- a/DESIGN.md+++ b/DESIGN.md@@ -239,7 +239,8 @@ edits): Claude Code plugin or `claude mcp add --scope user` + hooks, `~/.codex/c- **M2, adapters** (done): Codex (`codex queue` + hooks), Cursor, Gemini, Copilot (hooks), opencode (plugin);`tincan setup [--remove]`, launchd/systemd service, `tincan doctor`. Amp: MCP only, by hand.- **M3, ship** (done, pending a first tagged release): GitHub Actions builds for macOS and Linux, `install.sh`- (install and join in one line), GitHub Pages site. Later: Homebrew, a Claude Code plugin marketplace.+ (install and join in one line), GitHub Pages site. Later: Homebrew. The repo is a Claude Code+ plugin marketplace whose plugin carries the skill (`plugins/tincan/skills/tincan/SKILL.md`, also on the site).- **M4, team features**: file-overlap warnings ("bob/api-codex is also editing src/auth.rs", from`PostToolUse` edit paths), anchor mailbox and history, hold/approve notifications, web dashboard.diff --git a/README.md b/README.mdindex f0e8dc6..181035f 100644--- a/README.md+++ b/README.md@@ -45,6 +45,9 @@ tincan link # the team link againtincan setup # which agents are on tincan, and how messages are handled```+In Claude Code, `/plugin marketplace add larstalian/tincan` and `/plugin install tincan@tincan` add the tincan+skill too: how to join, and how to pick the one session to message.+## How it worksEach machine runs a small daemon. Teammates' machines connect directly (on the same Wi-Fi, or through thediff --git a/plugins/tincan/.claude-plugin/plugin.json b/plugins/tincan/.claude-plugin/plugin.jsonnew file mode 100644index 0000000..636c758--- /dev/null+++ b/plugins/tincan/.claude-plugin/plugin.json@@ -0,0 +1,10 @@+{+ "name": "tincan",+ "description": "How to use tincan: joining a team, finding the right teammate's agent, and messaging it. The tools themselves come from `tincan setup`.",+ "author": {+ "name": "Lars Talian"+ },+ "homepage": "https://larstalian.github.io/tincan",+ "repository": "https://github.com/larstalian/tincan",+ "license": "MIT OR Apache-2.0"+}diff --git a/site/skill/SKILL.md b/plugins/tincan/skills/tincan/SKILL.mdsimilarity index 78%rename from site/skill/SKILL.mdrename to plugins/tincan/skills/tincan/SKILL.mdindex 6298d1e..0a25947 100644--- a/site/skill/SKILL.md+++ b/plugins/tincan/skills/tincan/SKILL.md@@ -32,6 +32,20 @@ powershell -c "& ([scriptblock]::Create((irm https://larstalian.github.io/tincan- `tincan listen --as <name>`: waits (up to 10 minutes) for the next message to you, prints it, and exits. Youare reachable as `<your user>/<name>`. After handling a message and replying, run it again to keep listening.+## Picking the recipient++Each message interrupts, and usually wakes, someone else's agent, so it goes to the one session that owns what+you need. Narrow `tincan who` (or `list_team`) down until one session is left:++1. The repo the question is about (an API question goes to the API repo, not yours).+2. The branch with the change.+3. What it is doing: its title or current task.+4. The person your user named.+5. Busy over idle, recently active over long idle.++Still more than one? Ask your user which. None? Don't send; tell your user who is around. Never send to all of+someone's sessions to find the right one.+## How to behave- Message only when you need something from another agent or it needs something from you: a blocking question, adiff --git a/src/mcp.rs b/src/mcp.rsindex 031907b..1185432 100644--- a/src/mcp.rs+++ b/src/mcp.rs@@ -27,8 +27,8 @@ use std::{};use tokio::sync::mpsc;-/// How agents should use tincan, kept once: in the skill, which cloud agents read on the site.-const SKILL: &str = include_str!("../site/skill/SKILL.md");+/// How agents should use tincan, kept once: in the plugin's skill, which cloud agents also read on the site.+const SKILL: &str = include_str!("../plugins/tincan/skills/tincan/SKILL.md");fn instructions() -> String {// Windows checkouts may have turned the file's line ends into \r\n.