denoby/familiar

Familiar is a set of tools for the kitty terminal on macOS that add an IDE-like layer on top of coding sessions, especially for people using Claude Code, an AI coding assistant that runs in the terminal. It gives you three full-screen overlays, each opened with its own keyboard shortcut, that sit on top of your normal terminal work. The first overlay, called session, lets you see and manage your Claude Code sessions: which ones are currently busy, which ones are waiting for your permission to continue, and lets you resume, fork, or start new sessions, including creating a separate git worktree for one. The second overlay, review, is a two-pane code reviewer for changes you have not committed yet, showing a file tree next to a syntax-highlighted diff, letting you search across files, jump between changes, stage files, and write line comments that get collected into a note you can paste back into your chat with Claude. The third overlay, log, is a git history browser that shows a branch graph and lets you view diffs for any past commit, fetch and push, and copy commit hashes or file references to share with Claude. The review and log overlays work as plain git tools even if you are not using Claude Code at all, but the session overlay specifically needs Claude Code installed since it reads its session data. The whole thing is written in pure Python using only the standard library plus a bundled copy of Pygments for syntax highlighting, so there is nothing extra to install beyond the tool itself. Familiar only works on macOS, since it relies on Mac-style keyboard shortcuts and opens Mac IDE apps for editing files. It can be installed through Homebrew or by cloning the repository directly, and it works by adding a small block of configuration into your existing kitty terminal config file, which can be removed cleanly later.