Skip to content

montanaflynn/cctop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cctop

A terminal UI for monitoring and managing your running Claude Code sessions.

Features

  • Lists all running Claude Code sessions with PID, state, working directory, and terminal app
  • Session states: working (actively generating), waiting (needs your input), idle (at prompt)
  • Kill sessions directly from the TUI
  • Auto-refreshes every 2 seconds
  • Detects parent terminal app (Ghostty, iTerm, tmux, etc.)

Install

Homebrew

brew install montanaflynn/tap/cctop

Go

go install github.com/montanaflynn/cctop@latest

From releases

Download the latest binary from GitHub Releases.

Usage

cctop

Keybindings

Key Action
↑/↓ Navigate sessions
k Kill selected session
q / Esc Quit

How it works

cctop reads Claude Code's session files (~/.claude/sessions/*.json) and conversation logs to determine each session's state. It cross-references with running processes to detect the terminal app and working directory.

License

MIT

About

TUI for monitoring Claude Code sessions

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages