Skip to content

Home

Jump to bottom
Baidak.D edited this page Jul 11, 2026 · 5 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, and a git-log/diff browser. Pure Python standard library plus a bundled Pygments — nothing to install. 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 to paste back to Claude.
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

Reload the kitty config (Cmd+Ctrl+,) and press Cmd+Shift+S / R / L. 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 using only the standard library.

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.
  • 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