All shelves / Mods / Workflow
squad-chat
By chrisluo5311
squad-chat is a Claude Code workflow mod by chrisluo5311.
Opens a pane to chat with friends on your squad's own Supabase, plus rooms for usage, git, and every session's subagents.
Draws
Install
The marketplace name is squad-chat.
/plugin install squad-chat --marketplace chrisluo5311/squad-chatIt runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 1.1.1
- License
- MIT
- Repo stars
- 6
- Last change
- 2026-10-14
What it can reach
- Draws in the session
- Reads usage or context figures
- Reaches the network or an outside service
- Sees tool calls
- Runs a command when you press
- Calls another program on this machine
Needs Claude Code 2.1.292 or newer, in the terminal or the desktop app, and Node 22 or newer on PATH. Then /reload-plugins. One plugin: a chat pane, and built-in rooms that need no server. When Claude Code starts, the mod checks node --version and starts node bridge/dist/bridge.mjs, the process that talks to Supabase and to the room hosts. The mod talks to that process over a private Unix socket. supabase_url and supabase_key start empty. Set them in /config, or with claude plugin configure. Until a server is set, the pane says so. Chat messages, presence, and what you share go to that Supabase project. The README says messages are deleted after 30 days, whoever hosts the database can read it, and only members of a room can read it. Access is enforced in the database. You become a member with the room's passcode. Nothing typed in the pane enters the conversation. For /say, /room, and /chat-login, the arguments are replaced with a placeholder before Claude Code saves the command, and the command answers are notices the model never reads. The README says Claude Code still keeps a slash command's raw text in one bookkeeping line of the local transcript, so type passcodes in the pane if that matters. Your sign-in session is kept in ~/.config/squad-chat/session.json. /chat-logout removes it. Friends see the display name you picked, or the part of your email before the @, and whether you are online. They do not see your email. /chat opens the pane. Type in the pane and press Enter to send. Esc goes back to the prompt. In a terminal 110 columns wide or more the pane docks on the right. Narrower, it sits above the prompt. While the pane is closed, a line above the prompt shows the room, who is online, and what is unread, with an Open button. Rooms that are on without a server: Usage (context, rate limits, cost, and tool timings), Git (your branch, its pull request, and checks, through the gh CLI), Agents (every Claude Code session and its subagents), Focus (a Pomodoro timer), Habits, Toolbox, Pet (Clawd, moving with the session), Snippets, and Monitor. Clipboard, Weather, Tech News, Stocks, and Lo-fi stay off until you add them. The README says the built-in rooms read this session's figures from Claude Code, and git and gh in its folder as you, and that they send nothing of yours anywhere. gh talks to GitHub with your own sign-in. The Git room's requests are read-only: pull requests, checks, workflow runs, your issues, and open Dependabot alerts. The Clipboard room, once you add it, reads the clipboard every 2 seconds with pbpaste, wl-paste, or xclip and keeps the last 30 items in this session's memory only. The Monitor room reads CPU, memory, disk, network, battery, and GPU with vm_stat, sysctl, netstat, df, pmset, and ioreg on a Mac, macmon when it is there, and nvidia-smi on Linux. The README says that room uses no shell and no sudo. Weather, once added, sends the city names you set to api.open-meteo.com, geocoding-api.open-meteo.com, and air-quality-api.open-meteo.com. Tech News requests hacker-news.firebaseio.com and the feeds www.ithome.com.tw, www.theverge.com, feeds.arstechnica.com, and techcrunch.com, and nothing beyond the request. Stocks requests the symbols on your watchlist from mis.twse.com.tw and query1.finance.yahoo.com. Lo-fi, once added, plays ice2.somafm.com and www.youtube.com through your own mpv, and yt-dlp for YouTube, only when you press play. /chat notify starts off. /chat-share shows a preview of the selection, Claude's last code block, or a git diff, and posts only when you confirm. The room store reads raw.githubusercontent.com/chrisluo5311/squad-chat/main/rooms, nothing beyond the request, and installs a room only after you see its hosts and confirm. Nothing goes to Claude, to Anthropic, or to the author of squad-chat.
The install line has no @suffix. The marketplace name is squad-chat. The pane, with the Agents room of every session and its subagents, is why this page files it under workflow. The chat is the same pane. agentpane draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away. This Agents room is every Claude Code session on the machine. Each session keeps a small heartbeat in /tmp, under a squad-chat directory named for your user id, readable only by you: folder name, branch, model, and recent tool names with a few words each, secrets masked, never prompts or output.
Demo
What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/chat/say/room/who/chat-login/chat-share/chat-name/chat-logout/lofi/focus/habit/tool/snippetui.renderDraws into the sessionPaneAbovePromptui.scrollA Claude Code eventPaneturn.startWhen Claude starts a turnturn.completeWhen a turn endsturn.stepAt each step of a turnsession.measureWhen usage is measuredtool.callAround a tool call, where it can hold oneagent.spawnWhen a subagent startsui.closeWhen its pane closessession.appendWhen an entry is written to the transcriptsession.endWhen a session ends
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 6 files. They load when you open them.
Facts
- Author
- chrisluo5311
- Category
- Workflow
- Marketplace
- squad-chat
- Folder
- plugins/squad-chat
- Version
- 1.1.1
- License
- MIT
- Repo stars
- 6
- Last change
- 2026-10-14
- Language
- JavaScript
- Files
- 59