deziat/kitty-claude-status
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
1 commit 1 branch 0 tags 32 KiB
Find a file
Exact
Yuguo Cao 912cf06cd5 First commit
2026-04-02 17:00:24 +02:00
kitty-claude-status First commit 2026-04-02 17:00:24 +02:00
README.md First commit 2026-04-02 17:00:24 +02:00

README.md

kitty-claude-status

Claude Code tab status for kitty terminal.

Shows Claude's current state in the tab title and color using the Catppuccin Mocha palette. Sends macOS notifications with click-to-focus when Claude finishes or needs attention.

Install

./kitty-claude-status install

Uninstall

./kitty-claude-status uninstall

Features

Tab colors (Catppuccin Mocha)

State Color When
Ready Green #a6e3a1 Claude finished or session started
Thinking / Running Peach #fab387 Claude is working
Needs Input Blue #89b4fa Claude asked a question
Permission Yellow #f9e2af Claude needs tool permission

Tab titles

Formatted as folder: Status within a fixed 20-character budget. The folder name shortens first (minimum 3 chars), then the status.

Unfocused dot indicator

A ● prefix appears on unfocused tabs when Claude is in a "waiting" state (Ready, Needs Input, Permission). A kitty watcher automatically removes it when you switch to the tab.

macOS notifications

Clickable notifications via terminal-notifier that bring kitty to the foreground and focus the correct tab.

Requirements