Cc Companion banner
jiahongc jiahongc

Cc Companion

Development community

Description

A desktop companion app for Claude Code — monitors multiple instances all in one view

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

CC Companion

CC Companion Icon

A desktop companion app that monitors your Claude Code sessions in real time. Built with Electron.

CC Companion is a lightweight always-on-top window that sits at the top of your screen, tracking every Claude Code instance running on your machine — which project it's in, whether it's actively working or idle, CPU and memory usage, token consumption, conversation turns, and how long it's been in each state.

https://github.com/user-attachments/assets/df42aecd-d983-4839-9bad-8368281be0e0

Light mode Light mode working Settings panel
Light mode Working state Settings + detail
Dark mode detail Session history
Dark mode with detail panel Session history

Features

Claude Code Instance Tracking

  • Auto-detects all running Claude Code processes (filters out Claude desktop app and subagent processes)
  • Per-instance tile showing project name, model, status, and context usage
  • Session analytics: turn count, input/output token usage, context usage, model name — read directly from Claude's session files
  • Session timing: start time (with date if not today) and total elapsed time shown in detail panel
  • Anti-flicker: 3-second idle grace period pre