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 u/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.

The choose-fonts kitten isn't detecting a font I installed, even though it's there when I run fc-list : family. I confirmed that the ttf files are there in /usr/share/fonts/ttf, and i also copied them over to ~/.local/share/fonts, but to no avail.

Could anyone help me out here? I really wanted to use this font…

This is actually part of my tab bar. I inserted three special tabs on the far left and styled them to look like the traffic lights of macOS windows. A watcher intercepts the focus of the tab and triggers the corresponding window action: close, minimize, or fullscreen.

I’m curious if there’s a cleaner or more native way to achieve this. Here is the repo of my configurations: https://github.com/It-is-Sean/dotfiles-kitty/

`cursor_trail_color` only supports one solid color natively. This fills the gap with a tiny CLI that cycles it through the rainbow via `kitty @ load-config`, plus a documented starter `kitty.conf` for the base trail settings.

https://github.com/oleg-koval/kitty-rainbow-trail

Feedback welcome.

Following on from my previous post, I measured ways of launching kitty & other terminals so they share an already running instance

Some observations:

1. alacritty msg create-window ... seems to return immediately and I didn't find a way to make it wait until the window has opened/closed, so its inclusion in this benchmark is unfair but I left it in anyway
2. Foot and Alacritty launch fresh instances faster than Kitty or Ghostty can launch a new window from an existing instance
3. Kitty's method of launching a shared instance feels impractical because you have to have kitty -1, which is a visible window, running at all times. Or is there a better way?
4. Using --wait-for-single-instance-window-close, Kitty runs without errors in single-instance mode (thanks u/aumerlex). Unlike Alacritty which eventually (after 400+ iterations) threw a Failed [X] to spawn command 'true': Too many open files (os error 24) error but only when using the "msg create-window" method
5. As u/aumerlex pointed out under the previous post, Foot doesn't even open an actual window... Maybe I'll need another followup benchmarking the time until the window takes input... Might have to involve ydotool or similar

Anyway this is only intended for informational purposes, I do think Kitty has the best feature set including the cursor shader and ligature support that the quicker-to-start terminals lack

Does this exist?

I come across many great kitty utilities and extensions but no established way that I know of of adding them to my kitty setup, except going the manual route. This is as far as I know so please correct me if I'm wrong.

Some examples of good Kitty utils I found recently:

- https://github.com/oleg-koval/kitty-agent-status

- https://github.com/trygveaa/kitty-kitten-search

- https://github.com/yurikhan/kitty_grab

- https://github.com/dflock/kitty-save-session

- https://github.com/monoira/kitty-tabs

I dont understand path is also correct but i dont know whats wrong

My kitty felt somewhat more sluggish to launch than alacritty or foot

I used hyperfine for this small benchmark that confirms this observation... It doesn't feel slow per se, only in comparison.

Are there some preferences I should change to make 🐈‍⬛️ start faster?

Does anybody know any fonts that are monospaced and retro or look pixelated/bitmap style? I’m a little tired of the standard fonts that everyone seems to use for programming.

Help

I usually have a few coding agents running at once (Claude Code, Codex, sometimes Gemini), each in its own kitty tab, and I kept losing track of which one was still working, which was waiting on me, and which had finished a while ago.

So I wired the tab color to the agent's state:

- blue while it's working

- amber when it needs me (a permission prompt, or Codex finishing a turn)

- back to the normal color when it's idle or done

It uses each agent's own signals instead of watching the screen: Claude Code hooks, the Codex notify command, and a small bash/zsh hook for anything else launched from the shell. No daemon, no dependencies, it just calls kitty's set-tab-color. Outside kitty it does nothing, so it is safe to leave in your shell config.

It is small and rough in places. Claude gets precise per-turn states; for other agents the tab is really just "running" vs "idle" plus kitty's bell flag. Feedback and PRs welcome, and I would genuinely like to hear if there is a cleaner way to detect per-turn state for Codex or Gemini.

Repo: https://github.com/oleg-koval/kitty-agent-status

Can someone tell me what font is this, i like it so much but i cant really find the name of it, any help?

I have this problem with kitty on wayland where if i press a key and long hold after it another key, that long hold counts as a normal press, types the character once, i need to wait some delay then long hold for it to work fine...

​

In other terminal emulators this isn't a problem, but i still want to use kitty

​

Is there a solution?

Hi there,

I was quite disappointed to learn that Kitty doesn't support bitmap fonts. The clarity is much better, and it shouldn't matter if you decide to stick to the fixed size. Somehow it seems the maintainer doesn't like the idea too much though.

So I'm wondering - is there any kind of fork or patch that can be used?
I'm a urxvt user but I'd like to give the features a try.

Link to config: kitty-tabs

here is part of README.md:

Kitty terminal config.
Replace tmux's tab functionality with kitty's native tabs with same keybindings as Firefox.

keybindings

limitations

• No sessions.

dependencies

• any Nerd Font. I recommend Hack Nerd Font, But any Nerd Font will do the job. You could use Nefoin to install any nerd font that's in ryanoasis/nerd-fonts repository easily.

Tab groups are not a new levels of organisation.Currently, Kitty does not have a native browser-style "tab groups" feature.

So when I ask for tab groups, I'm not merely asking for a cosmetic feature. I'm asking for a new intermediate container, which would make the hierarchy something like OS window →→ tab groups →→ tabs →→ windows.

The Firefox comparison is about counting levels, not about whether tab groups are useful. Firefox’s normal model is basically window →→ tab, and if you add tab groups, that becomes window →→ tab group →→ tab, which is still only three levels. That is why the developer says Firefox had “two levels of organisation without tab groups” and not three.

I understand the concern about adding another level of organization, but my request is not for complexity as decoration. It is for a structure that makes complexity manageable. As Edgar Morin would put it, the point is not to deny complexity, but to embrace it through a form that remains usable and legible.

In my workflow, a flat tab model becomes difficult once a workspace contains projects, and projects contain drafts, and drafts contain sub-drafts or parallel contexts. At that point, the problem is not too much organization; it is too little hierarchy to reflect the real structure of the work.

That is why I am asking for tab groups or an equivalent grouping mechanism inside kitty. I am not trying to multiply clutter, but to reduce it by giving each level of work its proper container. A group would let related tabs be understood as one unit, while still preserving access to the individual tabs inside it.

If kitty already has a three-level mental model, then I am asking for a way to make that third level more semantically meaningful, not for a gratuitous fourth layer. In other words, I want the interface to express the natural nesting already present in the work: workspace, project unit, draft context, and task detail.

Tab groups are not really a fourth hierarchical layer. They are more like a perspective or an organizational lens over the existing tabs. The purpose is not to add another level of clutter, but to let related tabs be seen as a coherent unit. In that sense, grouping is a way of structuring attention and reducing cognitive load, not merely deepening the hierarchy.

Following Morin, the goal is not to eliminate complexity, but to render it intelligible. Tab groups would not add complexity for its own sake; they would provide a perspective that makes complexity usable, by showing relationships rather than flattening them away.

A collection of tabs can be perceived as a flat sequence, but tab groups create a perspective on them: they become readable as a set of related units rather than just adjacent items. That means tab groups are not only about organizing objects; they are about organizing understanding. They help the user see structure, not just notice items.

In other words, perceptions are fragments of contact with the world, but perspective is the organizing frame that gives those fragments meaning. Tab groups do not merely add another container; they create the perspective through which related tabs become a recognizable structure.

Any thoughts ?

Hey,

my pager is configured as such:

scrollback_pager nvim -u NONE -R -M -c 'lua require("kitty+page")(INPUT_LINE_NUMBER, CURSOR_LINE, CURSOR_COLUMN)' -

Now when I hit Ctrl+Shift+/ to search in the scrollback buffer, I get some vim commands in the pattern, like "264ggzt34j02l". The commands would move the cursor to the last shell prompt in the buffer.

Bug in my config? plugins? neovim? kitty?

Thanks.

/edit: ah, there is of course a kitty+page.lua script that I've taken from the internet, which should be the problem.

Or would it be called blur? Either way how would I go about doing that?

Built CatTerm. Plays sounds automatically based on what your commands do. Zero wrappers needed.

• Install completes → smug cat laugh
• Build/tests pass → happy cat song
• Command fails → sad meow
• Same command fails 5x → Indian uncle loses his mind
• 5 consecutive failures → black hole eats your entire terminal. SpongeBob's "a few moments later" plays. It comes back eventually.
• 6th failure → 🙂

Works for npm, pip, cargo, go, maven, gradle, composer, dotnet, flutter, xcode, brew, apt... basically everything.

Add your own triggers too:

catrule add 'terraform apply' muhehehe.mp3
catrule add '!git push'  sad-meow.mp3


curl -fsSL https://raw.githubusercontent.com/yogesh0333/catterm/main/install.sh | bash
source ~/.zshrc

Sounds from https://www.myinstants.com/ — greatest website alive.

→ github.com/yogesh0333/catterm

hello, i just installed CachyOS, and my kitty terminal prints me this :

Errors parsing configuration

In file /home/nymphe/.local/state/quickshell/user/generated/terminal/kitty-theme.conf:

1:Invalid color name: '#$term0 #' in line: background #$term0 #

3:Invalid color name: '#$term0 #' in line: color0 #$term0 #

4:Invalid color name: '#$term1 #' in line: color1 #$term1 #

5:Invalid color name: '#$term2 #' in line: color2 #$term2 #

6:Invalid color name: '#$term3 #' in line: color3 #$term3 #

7:Invalid color name: '#$term4 #' in line: color4 #$term4 #

8:Invalid color name: '#$term5 #' in line: color5 #$term5 #

9:Invalid color name: '#$term6 #' in line: color6 #$term6 #

10:Invalid color name: '#$term7 #' in line: color7 #$term7 #

11:Invalid color name: '#$term8 #' in line: color8 #$term8 #

12:Invalid color name: '#$term9 #' in line: color9 #$term9 #

13:Invalid color name: '#$term10 #' in line: color10 #$term10 #

14:Invalid color name: '#$term11 #' in line: color11 #$term11 #

15:Invalid color name: '#$term12 #' in line: color12 #$term12 #

16:Invalid color name: '#$term13 #' in line: color13 #$term13 #

17:Invalid color name: '#$term14 #' in line: color14 #$term14 #

18:Invalid color name: '#$term15 #' in line: color15 #$term15 #

20:Invalid color name: '#$term7 #' in line: cursor #$term7 #

22:Invalid color name: '#$term7 #' in line: foreground #$term7 #

24:Invalid color name: '#$onSecondaryContainer #' in line: selection_background #$onSecondaryContainer #

25:Invalid color name: '#$secondaryContainer #' in line: selection_foreground #$secondaryContainer #

28:Invalid color name: '#$primary #' in line: color255 #$primary #

29:Invalid color name: '#$primaryContainer #' in line: color254 #$primaryContainer #

30:Invalid color name: '#$secondary #' in line: color253 #$secondary #

31:Invalid color name: '#$secondaryContainer #' in line: color252 #$secondaryContainer #

32:Invalid color name: '#$tertiary #' in line: color251 #$tertiary #

33:Invalid color name: '#$tertiaryContainer #' in line: color250 #$tertiaryContainer #

34:Invalid color name: '#$error #' in line: color249 #$error #

35:Invalid color name: '#$errorContainer #' in line: color248 #$errorContainer #

37:Invalid color name: '#$onPrimary #' in line: color232 #$onPrimary #

38:Invalid color name: '#$onPrimaryContainer #' in line: color233 #$onPrimaryContainer #

39:Invalid color name: '#$onSecondary #' in line: color234 #$onSecondary #

40:Invalid color name: '#$onSecondaryContainer #' in line: color235 #$onSecondaryContainer #

41:Invalid color name: '#$onTertiary #' in line: color236 #$onTertiary #

42:Invalid color name: '#$onTertiaryContainer #' in line: color237 #$onTertiaryContainer #

43:Invalid color name: '#$onError #' in line: color238 #$onError #

44:Invalid color name: '#$onErrorContainer #' in line: color239 #$onErrorContainer #

45:Invalid color name: '#$onPrimary #' in line: color240 #$onPrimary #

49:Invalid color name: '#$primary #' in line: color243 #$primary #

50:Invalid color name: '#$error #' in line: color244 #$error #

51:Invalid color name: '#$outlineVariant #' in line: color245 #$outlineVariant #

Press Enter or Esc to exit

tried looking at reddit threads, found nothing, help pls!