Home (RU)

English · Русский

Клавиатурные оверлеи для терминала kitty, выстроенные вокруг работы с Claude Code — менеджер сессий для твоих ИИ-агентов, ревьювер незакоммиченных правок git с поиском по файлам всего проекта и просмотрщик истории/диффов git. Чистый Python (stdlib) плюс вложенный Pygments — ставить нечего, кроме языкового сервера, если нужен переход к определению. Только macOS.

Familiar — дух-помощник в облике кошки; в самый раз для набора kitty-китов, которые присматривают за твоими кодинг-агентами.

Каждый кит — полноэкранный оверлей, открывается по хоткею:

Кит	Хоткей	Что делает
session	Cmd+Shift+S	Просмотр и управление сессиями Claude Code — resume, fork, continue, новая сессия, git worktree, предпросмотр диалога транскриптом (с вызовами инструментов и их выводом), переименование и реальная активность (какие сессии запущены прямо сейчас).
review	Cmd+Shift+R	Двухпанельный ревьювер незакоммиченных правок git: дерево файлов + unified diff с подсветкой синтаксиса, word-diff, go to definition, поиск, прыжки по изменениям, git add из дерева и построчные замечания, собираемые в markdown — в буфер обмена или сразу в промт Claude. Cmd+Shift+F внутри оверлея — режим Find in Files: живой git grep по всему проекту.
log	Cmd+Shift+L	Просмотр истории git: список коммитов с графом веток, по коммиту — двухпанельный diff (тот же движок, что у review), git fetch / git push и копирование hash / @путь / @путь#L42 для промта Claude Code.

Быстрый старт

brew tap denoby/familiar https://github.com/DenoBY/familiar
brew install denoby/familiar/familiar
familiar enable --all
familiar lsp install python      # сервер на язык, ради перехода к определению

Перезагрузи конфиг kitty (Cmd+Ctrl+,) и жми Cmd+Shift+S / R / L (внутри review Cmd+Shift+F переключает в Find in Files). Подробности, режимы установки и удаление: Установка.

Требования

• macOS — хоткеи на Cmd, «open in editor» у review запускает macOS-приложения IDE, а вложенный конфиг терминала использует macOS-only опции kitty.
• kitty — проверялось на 0.47.
• git — нужен для review и log.
• Claude Code — нужен только для session; он читает ~/.claude (учитывает CLAUDE_CONFIG_DIR).
• Внешних Python-зависимостей нет — киты исполняются встроенным в kitty Python: стандартная библиотека плюс копия Pygments, которая идёт в комплекте с familiar (plugins/vendor). Без неё подсветка откатывается на встроенный регексп-лексер.
• Языковой сервер на язык — только ради перехода к определению в review и log. Ставит его familiar lsp install <язык>; без сервера всё остальное в обоих китах работает как обычно. См. Установку.

Карта wiki

• Установка — Homebrew tap, режимы установки, удаление/откат.
• session · review · log — что умеет каждый кит, полные раскладки клавиш, работа с Claude Code.
• Конфиг терминала — необязательный конфиг (вид, сплиты, табы) и фиксы русской раскладки.
• Восстановление окон — снимки открытых окон, возврат при старте и по Cmd+Shift+T, с продолжением сессий Claude Code с того же места.
• Темы — переключение тем и создание своей.
• Разработка — доработка familiar, тесты и демо-стенд, на котором сняты скриншоты этой wiki.

Лицензия

MIT — © 2026 DenoBY.