Eyes On Claude Code

English | 日本語

Eyes on Claude Code

An app that collects events from Claude Code global Hooks and lets you monitor session states across multiple projects via a menubar (tray) and a dashboard. It also plays nicely with tmux — view and interact with your panes right from the dashboard!

1. Setup

Supported platforms

- [x] macOS (12+)
- [ ] Linux (untested; may work)
- [ ] Windows (untested; pls someone helps us 🙇🏻‍♂️)

Prerequisites

- Claude Code
- Node.js v23+

Installation

Option 1: Download from Releases (Recommended)

1. Go to Releases
2. Download the appropriate file for your platform:
   - macOS: .dmg file
   - Linux: .deb or .AppImage file
   - Windows: .msi or .exe file
3. Install and launch the app

On macOS, you may see "App is damaged and can't be opened" error. See Troubleshooting for the workaround.

Option 2: Build from Source

First launch

On the first launch, the app shows instructions for installing the hooks configuration.

Follow the instructions in the Setup modal and apply the generated config to ~/.claude/settings.json.

The JSON shown in the Setup modal is generated by reading your existing settings and producing a JSON that only replaces the hooks (old eocc hooks are replaced, while other hooks/settings are preserved).

2. Usage

Dashboard

- The dashboard shows a list of Sessions.

Status display (top right)

- Monitoring: 0 sessions in a Waiting state (monitoring)
- N waiting: N sessions in WaitingPermission or WaitingInput
  - The dot on the top right also switches to a warning color and blinks when there are waiting sessions

Session states and display

There are four session states, and they are reflected in the list/tray/menu display as well.

Session card

- Click a card to expand it and see the Git status.

Diff (difit…