tomariGitHub

止まり木 · tomarigi, a perch for your sessions

Your Claude Code and Codex sessions, perched on the edge of your screen.

One pixel-art creature per session, resting on the edge of your Mac. It hops while the agent works, calls out when it needs you and holds up a check when it's done. Click it, and you're back in that session.

Meet the creatures
  • macOS 14+
  • Free and open source
  • Stays on your Mac
A replay drawn with Tomari's own sprites: a session asks for permission, you click it and you're in.

Moods気分

Know what every session is doing, at a glance.

Each creature acts out its session's state, and the ones waiting on you light up their tile. A look at the edge of your screen tells you where you're needed.

  • 作業中

    working

    Hops along with typing dots while Claude works on it.

  • 許可待ち

    needs permission

    Blinks its tile orange until you allow or deny. Hard to miss from across the room.

  • 質問

    asking you

    Rings itself in orange and raises a question mark when Claude asks you something.

  • 圧縮中

    compacting

    Squints while its conversation gets compacted.

  • 完了

    done

    Holds up a green check until you reply.

  • 居眠り

    asleep

    Dozes off five minutes after it finishes.

  • 失敗

    error

    Shakes its head when a turn fails.

  • 終了

    closed

    Fades to gray when its process stops. A click still reopens it.

止まり木

tomarigi · noun · a perch; a place for a bird to rest

A quiet spot for every session to rest while it works, and to call you over when it's ready.

Bash: npm run build

Make it yours自分らしく

Pick a creature for each session.

Right-click any creature on the strip to choose its character and color. They're plain 16×16 text templates, so you can draw your own too.

Character
Color
Mood

Features特徴

Made to sit quietly on your screen all day.

  • Claude Code and Codex, side by side

    Sessions of Claude Code and of OpenAI's Codex, CLI or app, share the strip. A badge in each creature's corner tells them apart: a spark for Claude, >_ for Codex.

  • Pin the ones you care about

    The + opens a Claude and a Codex tab with every session, running or stopped. Type to find one by name or folder. The rest show up only while they work or need you.

  • Hover for the details

    Each creature tells you its session's name, its agent and what it's doing, like Bash: npm test or done · 5m.

  • Click to jump in

    Opens the session where it lives: the Claude or Codex app, or its Terminal tab, even one that has already stopped. The one in front wears a white ring.

  • Never in the way

    Floats over every Space and full-screen app and never takes focus. Tuck it off the edge with its tab, which still blinks when you're needed, or hide it from the menu bar.

  • Light as a petal

    A native AppKit and Core Animation app with no Dock icon: about 0.5% of one CPU core and 13 MB of memory while it animates.

How it works仕組み

Small pieces, all on your Mac.

Claude Code and Codex report every event to a small local agent through their hooks. The strip listens to the agent and draws the creatures.

  1. hooksClaude Code · CodexEvery prompt, tool call and stop, straight from your sessions.
  2. 127.0.0.1tomari agentTracks each session's state, keeps your pins and opens sessions.
  3. WebSocket + tokentomari-overlayThe strip and the menu bar item. Native, and only a few megabytes.
0.5%
of one CPU core, give or take
13 MB
of memory while it animates
0
telemetry, ever
127.0.0.1
the only address it listens on

Install導入

One command, and they move in.

~
$ npx tomari setup
Tomari is installed and running.
  binaries : ~/Library/Application Support/tomari/bin
  data     : ~/Library/Application Support/tomari
  logs     : ~/Library/Logs/tomari
  hooks    : added to ~/.claude/settings.json
  codex    : hooks added to ~/.codex/hooks.json