Skip to content

Reason Network: your team's coding agents, talking to each other. The engine behind `reason network`.

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.json
new file mode 100644
index 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.yml
index 554c3bc..448f2b6 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -5,7 +5,7 @@ name: pages
on:
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 # v3
with:
diff --git a/DESIGN.md b/DESIGN.md
index 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.md
index f0e8dc6..181035f 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,9 @@ tincan link # the team link again
tincan 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 works
Each machine runs a small daemon. Teammates' machines connect directly (on the same Wi-Fi, or through the
diff --git a/plugins/tincan/.claude-plugin/plugin.json b/plugins/tincan/.claude-plugin/plugin.json
new file mode 100644
index 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.md
similarity index 78%
rename from site/skill/SKILL.md
rename to plugins/tincan/skills/tincan/SKILL.md
index 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. You
are 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, a
diff --git a/src/mcp.rs b/src/mcp.rs
index 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.