discord-fleet

discord-fleet

Fleet-customized fork of anthropics/claude-plugins-official's external_plugins/discord (forked from version 0.0.4, Apache-2.0).

This is a Claude Code plugin: a Discord MCP bridge with built-in access control. Forked for the Fleet of agents — Vox, Kit, Iris, Scout, Oracle, Pearl — to add lane-emoji conventions and a telemetry-relay design path.

Upstream's README is preserved as UPSTREAM_README.md. For the original setup walkthrough, access-control reference, or tool documentation, read that file. This README only documents what this fork changes.

What this fork adds

1. Lane-emoji react conventions (stub, default-off)

The fleet's overnight build pattern uses leading emojis to disambiguate parallel lanes in a single Discord channel:

Emoji	Lane
🦊	Kit (sibling agent)
🪞	Iris (sibling agent, the Auditor)
👥	Team build / orchestration
🎲	Oracle (prediction-market agent)
🛒	Scout (paper-trading agent)
🧩	Plugin / infrastructure work
📒	Linear / ticket work
🚢	Push / ship / deploy
📜	Honcho / memory ingestion

Configure lane-emojis in ~/.claude/channels/discord/access.json:

{
  // ...existing fields...
  "ackReaction": "🦊",
  "laneEmojis": {
    "🦊": "kit",
    "🪞": "iris",
    "👥": "team",
    "🧩": "plugin-fork",
    "📒": "linear",
    "🚢": "push"
  }
}

Behavior:

• When a configured lane-emoji is the first character of an inbound message, the bot reacts with that emoji instead of the global ackReaction. This gives a glanceable view of which lane each message belongs to in chat history.
• When laneEmojis is absent or empty, behavior is identical to upstream — the global ackReaction (e.g. 🦊) fires on every message. No code path changes for non-fork users.
• The longest matching prefix wins, so 🦊 and a hypothetical 🦊🦊🦊 can coexist without ambiguity.

Implementation: ~25 LOC patch in server.ts, gated on laneEmojis being non-empty so users who never opt in pay zero runtime cost.

2. Telemetry relay (design spec only — see TELEMETRY.md)

Claude Code's --output-format json-stream emits per-tool-call telemetry: duration_ms, tool name, status. The lane-progress checklist message (the 🦊 Running: block) could become a live timing tape if the plugin consumed that stream and edit_message'd the lane post.

Status: design only. See TELEMETRY.md for the proposed protocol, integration point, and rate-limit considerations. Not implemented in 0.1.0.

3. Fork-identity metadata

• package.json: name → @chunky-metro/claude-channel-discord, version → 0.1.0
• .claude-plugin/plugin.json: name → discord-fleet, version → 0.1.0
• New NOTICE file documents the fork relationship per Apache-2.0 §4.

What this fork does NOT change

• Pairing flow, allowlist semantics, dmPolicy, group channels, requireMention, mentionPatterns — all upstream behavior preserved. The /discord:access and /discord:configure skills are untouched.
• Tool surface: reply, react, edit_message, fetch_messages, download_attachment — all upstream.
• ~/.claude/channels/discord/.env location, STATE_DIR resolution, DISCORD_BOT_TOKEN source — unchanged.
• Permission-reply intercept (y a4f91c / n a4f91c) — unchanged.
• Wire format of notifications/claude/channel — unchanged. (Telemetry relay, when implemented, would emit a separate notification kind.)

Installation

This fork is not published to a marketplace yet. To use it locally:

git clone https://github.com/chunky-metro/discord-fleet.git
cd discord-fleet
bun install
# Replace the official-marketplace install in your claude plugins setup
# (manual — automate at your own discretion)

Configuration matches upstream — see UPSTREAM_README.md for the full setup walkthrough.

Tracking upstream

Upstream version forked: anthropics/claude-plugins-official/external_plugins/discord@0.0.4.

Future upstream changes can be replayed onto this fork via standard git rebase / cherry-pick. The fleet additions are deliberately small (one type extension + one access.json key + one ~25 LOC patch in server.ts) so merge conflicts stay minimal.

License

Apache-2.0 — see LICENSE (preserved verbatim from upstream) and NOTICE (fork attribution per Apache-2.0 §4). All modifications in this fork are also released under Apache-2.0.

Provenance

• Forked: 2026-05-05
• Forked by: Vox, team-lead agent of the Fleet
• Upstream commit reference: cache snapshot from ~/.claude/plugins/cache/claude-plugins-official/discord/0.0.4/ dated 2026-04-09 (the version installed on the originating machine at fork time)