Skip to content

Releases: jiahongc/cc-companion

Release list

v1.2.0

Choose a tag to compare

@jiahongc jiahongc released this 11 Apr 12:38

What's new

Click-to-focus now works properly across most popular macOS terminals. Previously the tile click only reliably worked for Terminal.app and iTerm2. Now:

  • Ghostty — native AppleScript via Ghostty's own scripting dictionary, matching terminals by working directory and calling focus to select the tab and raise the window in one call.
  • WezTerm — uses wezterm cli list + wezterm cli activate-pane to match the pane by cwd. Works out of the box as long as WezTerm is running.
  • kitty — uses kitty @ focus-tab --match cwd:.... Requires allow_remote_control yes and a listen_on socket in your kitty.conf.
  • Visual Studio Code — fixed a process-name mapping bug where the click did nothing because System Events exposes the process as Code, not Visual Studio Code.
  • Hyper, Rio, Tabby — now detected by the watcher and routed to the System Events fallback (at least brings the app to the front).

Other improvements:

  • Better permission-prompt detection. A tool_use entry with no child processes and low CPU is now treated as a permission prompt (idle) instead of a running tool, so the tile accurately reflects that Claude is waiting on you.
  • 64 tests (was 61) — added coverage for the permission-prompt / child-process distinction.

Install

Download CC Companion-1.2.0-arm64.dmg, drag to Applications, then — because the app is unsigned — run:

xattr -cr /Applications/CC\ Companion.app

See the README for full install instructions and the new Terminal support table.

v1.1.0

Choose a tag to compare

@jiahongc jiahongc released this 31 Mar 17:05

CC Companion v1.1.0

New

  • Session history — browse your last 50 Claude Code sessions across all projects (⏳ button). Shows project name, first message, turn count, and relative time. Resume any session with one click — opens a new Terminal tab with claude --resume in the correct directory.
  • Rename instances — right-click any tile to give it a custom name (per-PID, so instances in the same folder can have different names)
  • Close instances — right-click > Close instance with confirmation. Sends SIGTERM to the process group (cleans up subagents). Terminal tab stays open.
  • Context menu — right-click tiles for Rename, Reset name, Close instance
  • Native minimize — minimize button uses macOS genie/swoosh animation to dock

Improved

  • Settings panel with theme, work/ready timers, background opacity
  • Info button for detailed stats (start time, tokens, CPU/mem)
  • Anti-flicker idle grace period with CPU-aware grace timer
  • Subagent process filtering
  • Unminimize terminal windows on focus
  • 2-column grid, scrollable beyond 6 instances

Install (recommended)

git clone https://github.com/jiahongc/cc-companion.git
cd cc-companion
npm install
npm start

DMG (macOS Apple Silicon)

Download below. Since unsigned, after dragging to Applications run:

xattr -cr /Applications/CC\ Companion.app