ClaudeCodeMod

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.

In your shell
claude plugin marketplace add FairMind-Gen-AI-Studio/hopper-hq
claude plugin install hopper-hq@hopper-hq
Open the repo

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

The Claude Code mod section of the hopper-hq README: the mod reports each session and shows above the prompt who else is waiting for you, with a Go button to that tmux pane; /hopper-hq and the Open building button open the building; then the two install lines.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/hopper-hq
  • prompt.submitWhen you send a prompt
  • tool.callAround a tool call, where it can hold one
  • tool.checkA Claude Code event
  • agent.spawnWhen a subagent starts
  • turn.completeWhen a turn ends
  • session.endWhen a session ends
  • ui.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
Repo
FairMind-Gen-AI-Studio/hopper-hq
Folder
mod
Version
0.1.2
License
Apache-2.0
Repo stars
29
Last change
2026-10-19
Language
TypeScript
Files
8

Other mods in Workflow

taskplannersmekaiOpens a board of the repo's .tasks/ Markdown tasks beside the transcript to move, add, or start one with Claude, and names the one in progress above the prompt.agent-taskskeshrathOpens agent-tasks' stage-gated pipeline in a /pipeline pane beside the conversation: tasks by stage, artifacts and comments, advance, send back, and complete.deltazed-industriesRecords this session and its Git checkout to Delta, asks who should see it on /delta-share, and lets a teammate join the thread from their own Claude Code.ci-lightdavekissDraws a red row above the prompt while the repo's default branch fails CI, with how long and how many pushes since, and a quiet green under it otherwise.swarmery-linkatretyak1985Holds a commandReports this session's turns, tool calls, context, and cost to a local swarmery dashboard, and with options draws the plan phase and holds conflicting writes.agent-statusdodobrandsIn the desktop app, puts an icon before each session's name for working, waiting on you, stuck, or done, and lists its background tasks above the prompt.agentic-z-panelDayZ-n-ChillOpens a panel beside the chat with the DayZ mod's state and one-click buttons that run Agentic-Z's build, check, deploy, and launch scripts. Windows only.csr-lenscesarschutzHolds a commandOpens a panel in Portuguese beside the chat of the session's agents, turns, diffs, file tree, context and cost, and installed parts, and a row above the prompt.tempergalandoHolds a commandDraws a Temper run's stage bar above the prompt and a pane, and refuses writes outside the current stage, so no code is written before you approve the intent.agent-knowledgekeshrathOpens a /knowledge pane beside the chat to browse and search agent-knowledge, a git-synced memory vault that also searches past sessions of seven coding tools.memeshPCIRCLE-AIViews and edits MeMesh's project memories with /memesh-memories, in a pane in the desktop app or a form in the terminal, from one local file Codex shares.pr-watchElirazKedKeeps a live pane of the GitHub pull requests the session touches, with CI, reviews, conflicts, and merge, and a toast when one changes.
All 396 in Workflow