Skip to content

Home

Jump to bottom
Baidak.D edited this page Aug 26, 2026 · 13 revisions

English · Русский

Keyboard-driven overlays for the kitty terminal, built around a Claude Code workflow — a session manager for your AI agents, a git working-tree reviewer with project-wide Find in Files, and a git-log/diff browser. Pure Python standard library plus a bundled Pygments — nothing to install beyond a language server if you want go to definition. macOS only.

A familiar is a helper spirit in a cat's shape — fitting for a set of kitty kittens that tend your coding agents.

familiar — a quick tour of the overlays

Each kitten is a full-screen overlay opened by a hotkey:

Kitten Hotkey What it does
session Cmd+Shift+S Browse and manage Claude Code sessions — resume, fork, continue, new session, git worktree, transcript preview with tool calls and their output, rename, and live activity (which sessions are running right now).
review Cmd+Shift+R Two-pane reviewer for uncommitted git changes: file tree + syntax-highlighted unified diff, word-diff, go to definition, search, jump-by-change, staging files from the tree, and line comments collected into markdown — copied to the clipboard or pasted straight into Claude's prompt. Cmd+Shift+F inside the overlay — Find in Files mode: live project-wide git grep.
log Cmd+Shift+L Git history browser: commit list with a branch graph, per-commit two-pane diff (same engine as review), git fetch / git push, and copying hashes / @path / @path#L42 to feed Claude Code.

Quick start

brew tap denoby/familiar https://github.com/DenoBY/familiar
brew install denoby/familiar/familiar
familiar enable --all
familiar lsp install python      # a server per language, for go to definition

Reload the kitty config (Cmd+Ctrl+,) and press Cmd+Shift+S / R / L (inside review, Cmd+Shift+F switches to Find in Files). Details, install modes and uninstall: Installation.

Requirements

  • macOS — hotkeys are Cmd-based, review's "open in editor" launches macOS IDE apps, and the bundled terminal config uses macOS-only kitty options.
  • kitty — tested on 0.47.
  • git — required by review and log.
  • Claude Code — required by session only; it reads ~/.claude (honors CLAUDE_CONFIG_DIR).
  • No external Python dependencies — the kittens run on kitty's bundled Python: the standard library plus a copy of Pygments shipped with familiar (plugins/vendor). Without it, syntax highlighting falls back to a built-in regex lexer.
  • A language server per language — only for go to definition in review and log. familiar lsp install <language> puts one in place; without it the rest of both kittens works as usual. See Installation.

Wiki map

  • Installation — Homebrew tap, install modes, uninstall/rollback.
  • session · review · log — what each kitten does, full keymaps, Claude Code workflows.
  • Terminal config — the optional look/splits/tabs config and the Russian-layout fixes.
  • Restore — snapshots of the open windows, brought back on start and on Cmd+Shift+T, with Claude Code sessions resumed where they were.
  • Themes — switching themes and writing your own.
  • Development — hacking on familiar, tests, and the demo stand used for the screenshots in this wiki.

License

MIT — © 2026 DenoBY.

English

Русский

Clone this wiki locally