coding-agent-kit

Shareable configuration kit for agent-aware Kitty terminal tabs.

Colors and titles your Kitty tabs based on what your coding agent is doing — orange while thinking, green when done, red on failure. Works with Claude Code, Codex CLI, and your zsh shell.

Quick Start

git clone https://github.com/ryan-chen-opus/coding-agent-kit.git
cd coding-agent-kit
./install.sh

Requires fzf: brew install fzf

The installer detects your environment, lets you pick modules interactively, previews every change, and asks for confirmation before touching any file. All managed config blocks are marked with >>>>> Agent Kits: {module} <<<<< so they can be updated or removed at any time.

Modules

Module	What it does
kitty-base	Enables Kitty remote control — required for tab color/title
kitty-themes	Tab bar style, TokyoNight, Catppuccin Mocha themes
kitty-keymaps	Navigation shortcuts (tabs, panes, splits)
claude-hooks	Tab turns orange on prompt, green on stop, optional notifications
codex-hooks	Same for Codex CLI
zsh-hooks	Tab color by shell command exit code (green/red)
neovim-lazyvim	TokyoNight colorscheme matching the Kitty visual baseline

Supported Targets

• Terminal: Kitty
• Coding agents: Claude Code, OpenAI Codex CLI
• Shell: zsh
• Editor: LazyVim / Neovim
• Notifications: macOS Notification Center, Lark incoming webhook

Manual Install

If you prefer to copy files yourself, each module has its own README.md with step-by-step instructions and dependency notes.

1. Pick the modules you want
2. Open that module's README.md
3. Copy or merge the listed files into your config
4. Replace /ABSOLUTE/PATH/TO/THIS/REPO with the actual path

Module READMEs

• kitty-base
• kitty-themes
• kitty-keymaps
• kitty-scripts
• claude-hooks
• codex-hooks
• zsh-hooks
• neovim/lazyvim