GLOBUS ИНК

A Soviet space navigation computer that watches your Claude Code work in real time.

When Claude reads a file, the globe spins. When it's thinking, ВОЛК-7 squints. When there's an error, the whole panel shakes.

Why

The terminal is invisible. Claude Code types commands, reads files, runs searches — and if you're new to this, it all looks like noise. You don't know if it's working, stuck, or doing something you didn't ask for.

Globus makes it visible. Not as logs. As something you can actually watch.

Built for people who feel a little lost the first time they open a terminal and let an AI loose in their codebase.

终端是不透明的。Claude Code 在读文件、搜索、执行命令——如果你刚开始用，这些全是噪音。你不知道它在干嘛，有没有卡住，有没有做你没让它做的事。

Globus 让这些变得可见。不是日志，是你真的能看懂的东西。

给那些第一次打开终端、把 AI 放进自己项目里、心里有点慌的人做的。

Install

npx globus-ink

Requires Node.js 16+. No other dependencies.

Setup

1. Run npx globus-ink — the browser opens automatically and the hook script installs to ~/.globus/hook.sh

2. Add to ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse":  [{"matcher": "", "hooks": [{"type": "command", "command": "~/.globus/hook.sh"}]}],
    "PostToolUse": [{"matcher": "", "hooks": [{"type": "command", "command": "~/.globus/hook.sh"}]}],
    "Stop":        [{"matcher": "", "hooks": [{"type": "command", "command": "~/.globus/hook.sh"}]}]
  }
}

3. Start a Claude Code session — globe spins on the first tool call.

How it works

Claude Code hook → POST /event → SSE → browser

A local Node.js server (port 2137) receives hook payloads and fans them out via Server-Sent Events. The browser page connects once and stays live for the whole session.

If the server isn't running, the UI falls back to simulation mode automatically.

States

| ВОЛК-7 | Meaning | |--------|---------| | Eyes open | Standby | | Eyes squinting | Thinking / planning | | Amber glow | Executing a tool call | | Eyes shifted | Waiting for permission | | X eyes | Error |

Port

Default: 2137 (1957 + 180 — Sputnik launch year + orbital period in days)

Override: PORT=8080 npx globus-ink

License

MIT — @thehengyao