I built a set of kitty terminal overlays for the Claude Code workflow — review the agent's diff like in an IDE, juggle sessions, browse git history

https://i.redd.it/ftrqn1kp1mch1.gif

I run Claude Code in the terminal all day, and two things kept bugging me. Reviewing what the agent just changed meant either git diff in a pager or alt-tabbing to an IDE. And my sessions were scattered across project folders — getting back to one meant remembering where it lives, cd-ing there and running claude -resume by hand.

So I built familiar — three full-screen overlays for the kitty terminal, one hotkey each:

• review (Cmd+Shift+R) — two-pane reviewer for uncommitted changes: file tree + syntax-highlighted diff with word-level highlights, ⌥-click go-to-definition, an IDE-style "final code" view, staging from the tree. The part I use most is the feedback loop: drop line comments right in the diff, press w — they land in your clipboard as markdown, paste back into the Claude chat and it fixes them. And when you just need to point the agent at a spot, one key copies an @path/to/file.py#L42 reference ready for the prompt — no more "in that file, somewhere near that function".
• session (Cmd+Shift+S) — every Claude Code session across all your projects in one list: jump into any of them with a keystroke (resume, fork, or a fresh git worktree), no matter what directory you're in. Live status too — busy / waiting for permission / background agent — read from the process registry, not file mtimes. Plus a full conversation preview as a rendered transcript: tool calls, diffs, markdown.
• log (Cmd+Shift+L) — git history with a branch graph, per-commit diffs on the same engine, git fetch/git push without leaving the overlay.

Pure Python stdlib (Pygments vendored), no dependencies, MIT. Honest caveats: macOS only for now (Cmd-based hotkeys), and it's kitty-specific — it leans on kitty's kitten/overlay machinery. review and log work fine without Claude Code — they're just fast git overlays.

Repo + docs: https://github.com/DenoBY/familiar

Happy to answer questions — and curious what others use for reviewing agent-written diffs in the terminal.