Claude Code Discord Hq — Communication skill for Claude Code

claude-code-discord-hq

**Run your Claude Code sessions from your phone.** A Discord server defined as code, plus notifications that tell you when an AI coding session needs you.

[Português (Brasil)](README.pt-BR.md) · [Design format](docs/design-format.md) · [Security model](docs/security-model.md) · [Threat model](docs/threat-model.md)

[](https://github.com/FabianoArthur/claude-code-discord-hq/actions/workflows/ci.yml)  

---

What it is

Two tools that work well together, and also work on their own:

1. **Server as code.** You describe your Discord server in one TOML file: roles, categories, channels, who sees what, which channels are read-only, forum tags, webhooks, Community settings and pinned messages. `discord-hq plan` shows the difference with the live server. `discord-hq apply` makes the server match, idempotently: a second run changes nothing.

2. **Claude Code notifications.** A `Notification`/`Stop` hook and a small watchdog tell you, on your Mac and in Discord, when a session:

   • needs approval,
   • stopped,
   • hung without progress,
   • is waiting for you,
   • opened its pull request.

   A live panel message shows every session at a glance.

Combined with the official Claude Code Discord plugin (`/plugin install discord@claude-plugins-official`), you can talk to your main session from your phone and get pinged when the work is ready to review.

Why: the waiter and the kitchen

This project came out of a way of working with Claude Code that uses a restaurant as the metaphor:

Role	What it is	What it does
Waiter	your main Claude Code session	Talks to you, takes orders, sends them to the kitchen and serves the results. It never cooks: it doesn't edit code itself.
Kitchen