All shelves / Mods / Workflow
hopper-hq
By FairMind-Gen-AI-Studio
hopper-hq is a Claude Code workflow mod by FairMind-Gen-AI-Studio.
Draws a band above the prompt while another session waits for you or has finished, and opens hopper-hq, a browser office where each session has a desk.
Draws
Install
The marketplace name is hopper-hq.
claude plugin marketplace add FairMind-Gen-AI-Studio/hopper-hq claude plugin install hopper-hq@hopper-hq
It 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
- 0.1.2
- License
- Apache-2.0
- Repo stars
- 29
- Last change
- 2026-10-19
What it can reach
- Draws in the session
- Sees tool calls
- Calls another program on this machine
Needs Node 22.13 or later and the hopper-hq CLI on your PATH: npm install -g @fairmind-ai/hopper-hq. Type /hopper-hq in any session to open the building; it runs hopper-hq up, which also starts the daemon, and takes no turn of the model. The band's Open building button does the same. tmux is optional, needed only for the status line and the Go buttons, which switch tmux to that session's pane. Without the mod, hopper-hq still works from the files Claude Code writes, with up to a second of delay and less detail about why a session waits. From a clone: claude --plugin-dir /path/to/hopper-hq/mod. The README calls it early.
The marketplace, hopper-hq, holds this one plugin, from the repository's mod folder. Knowing which session needs you is why this page files it under workflow. corgi-band draws corgi sessions waiting on you above the prompt. baton draws this session, the other sessions, and the tasks passed between them. This one sits on hopper-hq, a local daemon and an isometric office building in the browser: one floor per feature, a desk per Claude Code or Codex CLI session, interns for subagents, and a red window when someone waits for you. The mod reports each session as things happen, with the exact reason it waits. One-line summaries of where a session stands are off by default; a language model writes them, Claude through the claude CLI or the Anthropic API. It is provided by FairMind, under the Apache License 2.0.
Demo

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/hopper-hqprompt.submitWhen you send a prompttool.callAround a tool call, where it can hold onetool.checkA Claude Code eventagent.spawnWhen a subagent startsturn.completeWhen a turn endssession.endWhen a session endsui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/hopper-hqOpen the hopper-hq building in your browser, starting its daemon if needed
Hooks 11
SessionStartnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"UserPromptSubmitnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"PreToolUsenode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"PostToolUsenode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"PostToolUseFailurenode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"PermissionRequestnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"Notificationnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"Stopnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"SubagentStartnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"SubagentStopnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"SessionEndnode "${CLAUDE_PLUGIN_ROOT}/scripts/hook.mjs"
Files
The author's source, 3 files. They load when you open them.
Facts
- Author
- FairMind-Gen-AI-Studio
- Category
- Workflow
- Marketplace
- hopper-hq
- Folder
- mod
- Version
- 0.1.2
- License
- Apache-2.0
- Repo stars
- 29
- Last change
- 2026-10-19
- Language
- TypeScript
- Files
- 8