https://github.com/getopsdeck/opsdeck
Monitor all your Claude Code sessions from a single terminal
https://github.com/getopsdeck/opsdeck
bubbletea claude-code dashboard developer-tools go monitoring terminal tui
Last synced: 3 months ago
JSON representation
Monitor all your Claude Code sessions from a single terminal
- Host: GitHub
- URL: https://github.com/getopsdeck/opsdeck
- Owner: getopsdeck
- License: mit
- Created: 2026-03-22T01:31:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-22T15:52:51.000Z (3 months ago)
- Last Synced: 2026-03-22T18:25:21.275Z (3 months ago)
- Topics: bubbletea, claude-code, dashboard, developer-tools, go, monitoring, terminal, tui
- Language: Go
- Homepage: https://github.com/getopsdeck/opsdeck
- Size: 2.67 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OpsDeck
[](https://github.com/getopsdeck/opsdeck/actions)
[](https://github.com/getopsdeck/opsdeck/releases)
[](LICENSE)
[](https://goreportcard.com/report/github.com/getopsdeck/opsdeck)
**Chief of Staff for Claude Code** — monitor all your sessions from a single terminal.
Running 8+ Claude Code sessions? Lost track of which one is waiting for you,
which one is still working, and which one crashed 20 minutes ago?
OpsDeck gives you a real-time TUI dashboard, a browser-based web dashboard,
daily briefs, productivity metrics, cost analytics, and an AI-powered morning
summary — all from a single Go binary with zero config.
```
OpsDeck 12 sessions | 3 projects
--------------------------------------------------------------------------------
PROJECT SESSION STATE STARTED LAST ACTIVITY
--------------------------------------------------------------------------------
opsdeck/
abc1234 PID 9812 BUSY 14:02 Implementing TUI styles
def5678 PID 9834 WAITING 13:45 Tests passing, awaiting input
my-api/
fed8765 PID 8201 BUSY 12:30 Refactoring auth middleware
cba4321 PID 8244 BUSY 12:32 Writing integration tests
aaa1111 PID 8290 IDLE 11:15 Last: updated README
bbb2222 PID 8301 DEAD 9:40 --
frontend/
cc33333 PID 7100 WAITING 14:10 Waiting for approval
dd44444 PID 7112 BUSY 14:08 Running test suite
ee55555 PID 7150 IDLE 10:22 Last: fixed CSS layout
ff66666 PID 7200 DEAD 8:15 --
gg77777 PID 7250 WAITING 13:55 Ready for next task
hh88888 PID 7300 BUSY 14:12 Deploying to staging
--------------------------------------------------------------------------------
j/k navigate | / search | 1 waiting 2 busy 3 idle 4 dead | Tab view | q quit
```
## Install
```bash
go install github.com/getopsdeck/opsdeck/cmd/opsdeck@latest
```
Or download a binary from the [releases page](https://github.com/getopsdeck/opsdeck/releases).
Requires Go 1.26+ for source builds. No other dependencies.
## Quick Start
```bash
opsdeck
```
That is it. No config files, no setup, no flags. OpsDeck finds your Claude Code
sessions automatically and starts showing them.
## Commands
```bash
# Real-time TUI dashboard (default)
opsdeck
# Daily briefing — what happened across all your projects
opsdeck brief
opsdeck brief --since 2h # last 2 hours only
opsdeck brief --since 48h # last 2 days
# Productivity metrics — today vs yesterday comparison
opsdeck metrics
# One-line status — for shell prompts or tmux
opsdeck status
# List all sessions — compact overview
opsdeck list # or: opsdeck ls
opsdeck list --json # JSON output for scripting
# Cost analytics — powered by ccusage (https://github.com/ryoppippi/ccusage)
opsdeck costs # delegates to npx ccusage --breakdown
opsdeck costs session # per-session breakdown
opsdeck costs monthly # monthly aggregation
opsdeck costs --instances # per-project breakdown
# AI-powered brief — natural language morning summary (opt-in, costs tokens)
opsdeck ai-brief
# Export brief to markdown file
opsdeck export
# Show dead sessions for cleanup
opsdeck clean
# Resume a session — opens claude --resume in the session's directory
opsdeck resume
opsdeck resume 2820 # prefix match
# Watch mode — monitor sessions, alert on state changes
opsdeck watch # macOS desktop notifications included
# MCP server — let Claude Code query your sessions
opsdeck mcp-serve # JSON-RPC over stdio
# Register: claude mcp add opsdeck -- opsdeck mcp-serve
# Tools: get_sessions, get_brief, get_costs, get_session_detail
# Web dashboard — browser-based UI with real-time updates
opsdeck web # opens http://localhost:7070
opsdeck web :8080 # custom port
# Version
opsdeck version
```
## Features
- **Auto-discovery** -- finds all Claude Code sessions on your machine by
scanning `~/.claude/sessions/` and the sessions index
- **Real-time status** -- classifies each session as busy (active in last 30s),
waiting (30s--5min, likely needs you), idle (5min+), or dead (process gone)
- **Project grouping** -- sessions are grouped by working directory so you can
see all sessions for a given project at a glance
- **Keyboard driven** -- vi-style navigation (j/k), search (/), numeric state
filters (1--4), tab to switch views
- **Auto-refresh** -- dashboard updates every 3 seconds; press `r` to force
- **Zero config** -- no YAML, no ENV vars, no API keys
- **Read-only** -- OpsDeck only reads session data; it never modifies sessions
or sends signals to processes
- **Local-only** -- all data stays on your machine; nothing is sent anywhere
- **Web dashboard** -- `opsdeck web` opens a browser-based view with SSE
real-time updates, same data, same dark theme
### Web Dashboard
## Keyboard Shortcuts
| Key | Action |
|-----------|---------------------------------|
| `j` / `k` | Move cursor down / up |
| `Enter` | Toggle detail panel for session |
| `/` | Start search |
| `Esc` | Cancel search / clear filter |
| `1` | Filter: waiting sessions |
| `2` | Filter: busy sessions |
| `3` | Filter: idle sessions |
| `4` | Filter: dead sessions |
| `0` | Clear state filter |
| `Tab` | Toggle project / flat view |
| `r` | Force refresh |
| `q` | Quit |
## How It Works
OpsDeck reads three data sources, all local and read-only:
1. **Session files** (`~/.claude/sessions//session.json`) -- each file
contains the session ID, PID, and working directory
2. **Sessions index** (`~/.claude/sessions/sessions-index.json`) -- provides
summaries and message counts
3. **Transcripts** (`~/.claude/sessions//transcript.jsonl`) -- the last
entry's timestamp determines activity recency
Process liveness is checked via `kill -0` (macOS/Linux), which only tests
whether the PID exists -- it does not send any signal to the process.
State classification:
| State | Meaning |
|-----------|--------------------------------------------|
| `BUSY` | Process alive, activity within last 30s |
| `WAITING` | Process alive, activity 30s--5min ago |
| `IDLE` | Process alive, no activity for 5min+ |
| `DEAD` | Process no longer running |
## Roadmap
- **v0.1** -- Core TUI dashboard + daily brief + productivity metrics
- **v0.3** -- Web dashboard with SSE real-time updates
- **v0.4** -- Cost analytics: token usage and estimated spend per session
- **v0.5** -- AI-powered brief via `claude -p` (current)
## Privacy
OpsDeck reads local session files and checks process liveness via the OS.
There is no telemetry and no analytics. All data stays on your machine.
The one exception is `opsdeck ai-brief`, which pipes session data through
`claude -p` for AI summarization. This is opt-in and clearly marked.
## Comparison
| Feature | OpsDeck | claude-squad | ccusage | Claud-ometer |
|---------------------------|---------|--------------|---------|--------------|
| Real-time TUI dashboard | Yes | Yes | No | No |
| Web dashboard | Yes | No | No | No |
| Auto-discovers sessions | Yes | No (managed) | Yes | Yes |
| Session state detection | Yes | Yes | No | Partial |
| Project grouping | Yes | No | No | No |
| Daily brief | Yes | No | No | No |
| Productivity metrics | Yes | No | No | No |
| Session activity detail | Yes | No | No | No |
| Session timeline | Yes | No | No | No |
| Git branch / status | Yes | No | No | No |
| AI-powered brief | Yes | No | No | No |
| Zero config | Yes | No | Yes | Yes |
| Read-only / non-invasive | Yes | No (manages) | Yes | Yes |
| Cost analytics | Yes | No | Yes | Yes |
| MCP server | Yes | No | Yes | No |
| Keyboard navigation | TUI+Web | Yes | No | No |
OpsDeck is designed to complement your existing workflow. It does not manage or
spawn sessions -- it observes them. Use it alongside claude-squad or on its own.
Cost analytics are powered by [ccusage](https://github.com/ryoppippi/ccusage)
-- the best token usage tracker for Claude Code. Install it with
`npm i -g ccusage` for accurate pricing from LiteLLM. OpsDeck focuses on live
session monitoring and operational intelligence; ccusage handles cost tracking.
## Requirements
- macOS or Linux (Windows support planned for a future release)
- Claude Code installed (OpsDeck reads its session files)
## Contributing
Contributions are welcome.
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/my-change`)
3. Write tests first, then implement (`make test`)
4. Ensure `make lint` passes
5. Open a pull request
Please open an issue before starting work on large changes.
## License
MIT