Panoptes

Press Space to jump to the next session that needs you.

Running multiple Claude Code sessions across different projects? Panoptes shows them all in one terminal — who's thinking, who's executing, who's waiting for input. Get notified when sessions need attention. Switch instantly with a keystroke.

It's a minimal wrapper, not a new tool to learn. You still use Claude Code exactly as before — Panoptes just makes juggling multiple sessions painless.

Named after the hundred-eyed giant of Greek mythology.

Features

• Multi-Session Management - Run multiple Claude Code sessions in parallel, each with its own conversation and context
• Project & Branch Organization - Sessions organized by git repository and branch. Panoptes automatically creates isolated worktrees so each branch has its own working directory — no manual setup required
• Real-Time State Tracking - See what each session is doing: Thinking, Executing, Waiting for input, or Idle
• Attention System - Get notified when sessions need your input, with visual badges and terminal bell alerts
• Activity Timeline - View all sessions sorted by recent activity across all projects
• Focus Timer - Built-in Pomodoro-style focus timer with per-project time tracking
• Keyboard-Driven Interface - Fast navigation with vim-style keys and number shortcuts
• Session Naming - Name sessions for easy identification ("frontend-auth", "api-refactor")

Quick Start

Prerequisites

• Claude Code CLI installed and configured

Install

cargo install panoptes-cc

Then run:

panoptes

Build from Source

git clone https://github.com/ivan-brko/panoptes.git
cd panoptes
cargo build --release
./target/release/panoptes

First Steps

1. Press a to add your first project (enter the path to a git repository)
2. Navigate to a project with Enter, then to a branch with Enter
3. Press n to create a new session
4. Enter a name for the session and press Enter
5. You're now in Session mode - type to interact with Claude Code
6. Press Shift+Escape to exit Session mode
7. Press Esc to navigate back through the hierarchy

Documentation

• Installation Guide - Detailed setup instructions
• Keyboard Reference - Complete keyboard shortcut reference
• Configuration Guide - All configuration options explained
• Troubleshooting - Common issues and solutions
• Product Overview - Detailed feature descriptions
• Technical Architecture - How Panoptes works under the hood

Keyboard Shortcuts

Essential Navigation

Project Management

Views

See Keyboard Reference for the complete list.

Configuration

Configuration is stored in ~/.panoptes/config.toml:

hook_port = 9999                # HTTP server port for Claude Code hooks
idle_threshold_secs = 300       # Seconds before session shows attention badge
notification_method = "bell"    # "bell", "title", or "none"
focus_timer_minutes = 25        # Default focus timer duration

See Configuration Guide for all options.

Session States

Data Locations

Development

cargo build              # Build debug
cargo build --release    # Build release (with LTO)
cargo test               # Run all tests
cargo clippy             # Lint
cargo fmt                # Format code

License

MIT - see LICENSE for details.