Familiar: An IDE-Style Terminal Overlay for AI Agent Workflows

Research context and background

Familiar is a software suite designed for the kitty terminal emulator. It acts as a bridge between a standard command line and a full code editor. The tool creates full-screen overlays that help developers manage AI coding agents like Claude Code and handle Git workflows without leaving their terminal window. The name comes from the idea of a helper spirit, fitting for the small tools that assist with coding tasks.

Benefits

Familiar offers several key advantages for developers who want to keep their workflow inside the terminal. It provides three main overlays that can be opened with simple keyboard shortcuts. The first is a session manager that lets users start, pause, or resume AI coding sessions. It also shows live activity so users can see which tasks are running. The second overlay is a code reviewer. It displays file changes in a two-pane view with syntax highlighting. Users can navigate code, stage files for commits, and collect comments to send back to their AI agent. The third overlay is a Git history browser. It shows a visual graph of branches and allows users to view commit details and run Git commands directly. All these features work without needing extra Python libraries because they use the built-in Python in the kitty terminal.

Use Cases

This tool is ideal for developers who use the kitty terminal and work with AI coding assistants. It is perfect for managing multiple AI sessions at once without switching windows. Developers can review code changes quickly using the built-in diff viewer instead of opening a separate editor. The Git history browser helps teams track project changes and copy commit hashes to feed into AI tools. It also supports different themes like the popular Darcula color scheme to match user preferences. The tool works well on macOS and supports Russian keyboard layouts automatically. Since it is open source and uses the MIT license, users can modify the code if they need custom features.

Pricing

Familiar is free to use. It is released under the MIT License, which means anyone can download, use, and modify the software without cost. Users can install it via Homebrew or by cloning the repository from GitHub.

Vibes

As an open-source project hosted on GitHub, Familiar has not yet gathered a large number of public reviews or testimonials. However, the project description highlights its clean design and ease of use. The developers emphasize that the installation is reversible, meaning users can restore their original terminal settings easily if they choose to uninstall the tool. This feature suggests a focus on user safety and flexibility.

Additional Information

Familiar is developed by DenoBY and is available on GitHub at the repository denoby/familiar. The project requires the kitty terminal emulator version 0.47 or later. It works best on macOS because the hotkeys use the Command key. The software does not require any external Python dependencies as it runs on the standard library included with kitty. Users can enable specific features like the session manager or code reviewer individually or turn on all features at once. The tool also includes a backup system that saves the original kitty configuration file so users can return to their previous setup anytime.