▚ WHAT IS IT

One cartridge. No plugin soup. Turns Hyper into a vertical arcade HUD — every module toggles from one config block.

▚ FEATURES

• VERTICAL TABS — dual-row HUD, live cwd (OSC 7), agent icons, pane-count badges, drag & drop reorder, resizable dock
• CLOSE GUARD — confirms before closing a tab/window still running a command (native dialog)
• INVENTORY PANEL — probes 87 tools, agents, runtimes & languages
• STATUS PANEL — Wi-Fi, throughput, battery, CPU, RAM, dir, clock
• EXPLORER — whole-disk folder tree from the status panel, opens a new tab at any folder, pin to bookmark
• BOOKMARKS — pinned folders as a grid, one click opens a new tab there
• NOW PLAYING — pick any playing app: cover, transport, volume slider (browser tabs too)
• AGENT MONITOR — popup cards for opencode permission requests; per-agent on/off, scoped to this Hyper window by default (mDNS + port scan)

▚ INSTALL

git clone https://github.com/jonaskahn/hyper-kit.git ~/.hyper_plugins/local/hyper-kit
cd ~/.hyper_plugins/local/hyper-kit
npm install && npm run build

Add to ~/.hyper.js, quit & relaunch Hyper (Cmd + Q):

localPlugins: ['hyper-kit'],

▚ CONFIG

All knobs under hyperKit in ~/.hyper.js:

hyperKit: {
  leftPanel: { enable: true, envPanel: true, mediaPanel: { enabled: true } },
  bottomPanel: true,
  topPanel: { enabled: true, runningCat: true }, // running cat
  explorer: true,
  bookmarks: true,
  paneCountBadge: true,
  agentIcons: true,
  newTabSameDir: true,
  confirmClose: true,
  agentMonitor: {
    enabled: true,
    popup: true,
    scope: 'self',          // 'all' | 'hyper' | 'self'
    optimistic: true,
    agents: {               // per-agent monitor toggle
      opencode: true,
      claude: true,
      codex: true,
      agent: true,          // cursor agent CLI (also matches 'cursor')
      agy: true,
      // everything else defaults off: gemini, copilot, aider, amp, goose,
      // devin, qwen, kiro, kimi, openhands, zed, windsurf, trae
    },
  },
},

agentMonitor.scope decides which opencode instances get caught: 'self' (default) only this Hyper window's tabs, 'hyper' any Hyper instance, 'all' every terminal on the machine. agentMonitor.agents turns the monitor on per agent; optimistic: true treats an unreachable reply (request already answered another way) as accepted — any button closes the card instead of erroring.

agentMonitor.persist keeps a permission card on screen until you answer. heartbeatSec (15) = rescan cadence; debounceMs (150) = scan coalescing. Without the OSC 7 hook, tab attribution falls back to the unique opencode tab.

▚ OSC 7 (LIVE PWD)

| shell | hook | | :-------------- | :----------------------------------------------------------------------------------------------------- | | zsh | precmd() { printf '\e]7;file://%s%s\a' "$HOSTNAME" "${PWD// /%20}" } | | bash / git-bash | PROMPT_COMMAND='printf "\e]7;file://%s%s\a" "$HOSTNAME" "${PWD// /%20}"' | | powershell | function global:Set-Osc7 { $p = $PWD.Path -replace ' ', '%20'; Write-Host "e]7;file://$env:COMPUTERNAME$pa" -NoNewline }; Set-Alias cd -Value Set-Osc7 -Force |

▚ DEV

npm run build     # compile TS → dist/
npm run test      # vitest suite
npm run check     # typecheck + lint + format + tests + build

npm run check is CI's gate. Strict mode: no unused exports, locals or params.

▚ TROUBLESHOOTING

| symptom | fix | | :----------------- | :-------------------------------------------------- | | no tab bar | npm install && npm run build, relaunch Hyper | | plugin not loading | folder must be named exactly hyper-kit | | stale UI | full quit Cmd + Q — config doesn't hot-reload | | build errors | Node 18+, delete node_modules + dist, reinstall |