Astro

Astro turns kitty into a workspace for agent CLIs such as Claude Code, Codex and Hermes. It is not a fork of kitty's source code: it is a configuration plus a title-bar extension that runs inside an unmodified kitty.

Features

Meet Astro

The mascot is based on Astro, a real long-haired brown/grey tabby: tall ears, a dark forehead M, a pink nose and a cream ruff. In the owner's front-facing reference, the missing/closed eye is on the viewer's left and the single open pale green eye is on the viewer's right. The icon and both ASCII cat poses keep that exact orientation; do not mirror them. The cat stays minimal, without detailed whiskers or cheek stripes. Its background is a terminal window with only slightly rounded corners (16px radius on a 512px canvas), a title bar and a small prompt. The entire cat head sits 24 SVG units lower beneath the title bar. GNOME palette colors connect the frame and wordmark to the terminal; the cat retains its natural fur and eye colors. Reference photographs are personal and are not distributed in this repository.

New Bash terminal panes greet you with an animated cat action: First contact, Cursor hunt, Star jump, Tail chase, Cat nap, Zoomies, Grooming, Yarn physics, Box inspector or Window watch. Each has its own articulated poses and props, not the same portrait with different particles. Zoomies retains its original running sprite and motion. A persistent shuffle bag shows all ten before repeating, including when several panes open together. The selected action loops until you start typing; there is no automatic dismissal timer. The first input is left in its terminal queue for the shell. Rendering updates only changed rows at 12 fps. Cycle coordination is best effort: an unavailable/unsafe cache or a lock held for more than 200 ms selects a random action instead of waiting indefinitely for another pane. Cache symlinks and non-regular files are not followed. The greeting adds no scrollback. Descendant Bash shells skip the greeting in the same pane. Command shells such as bash -ic start their agent or monitor immediately; their greeting waits until a real interactive prompt is opened. Direct non-shell command launches, tiny panes, redirected output and TERM=dumb skip it too. Bash remains the normal login shell, preserving kitty's native shell integration.

# Disable greetings for terminals started from this environment.
export ASTRO_ANIMATION=off
# Alternatively set `env ASTRO_ANIMATION=off` in kitty.conf.
# REDUCE_MOTION=1 also disables them; NO_COLOR disables their colors.

# List or preview a specific effect (1–10).
python3 ~/.config/kitty/astro_intro.py --list
python3 ~/.config/kitty/astro_intro.py --effect 6 --duration 3

Astro Bash prompt

The familiar user@host:path$ layout uses the owner's reference colors: purple username (#a76fc1), grey @ and colon (#9a968f), golden hostname (#fabd2f), a quiet neutral path (#bebdba) and a softer gold prompt symbol (#caaa68). These explicit RGB roles affect only the prompt; applications keep the GNOME Soft ANSI palette and the neutral #191919 background. This is scoped to interactive Kitty Bash sessions; other terminals are unchanged. Readline wrapping and kitty's native shell integration remain intact. In interactive Kitty shells where TERM is xterm-kitty, Astro also defines a lightweight nvtop wrapper (TERM=xterm-256color) unless you already define nvtop, so capability-enabled nvtop binaries (cap_perfmon) work when xterm-kitty is not installed in system-wide terminfo. Set ASTRO_PROMPT=off to keep your existing prompt; NO_COLOR or a dumb terminal selects a plain prompt. To update an already open Bash shell, run:

source ~/.config/kitty/astro_prompt.bash

Pane controls in every title bar

Control	Shortcut	Action
+→ / +↓	Ctrl+Alt+R / Ctrl+Alt+D (+Shift: column / row)	Open a terminal to the right / below in the current directory
▦	Ctrl+Alt+P	Cycle the pane's group: none → 1 → 2 → 3 → 4 → none (colored)
|↔|	Ctrl+Alt+=	Give every pane of this group the same width
⇕	Ctrl+Alt+Shift+=	Give every pane of this group the same height
copy	Ctrl+Shift+C	Copy the selection
>_	Ctrl+Alt+O	Copy the last shell command with its output
keyboard	Ctrl+Alt+/	Show kitty's keyboard shortcuts in a separate tab
zoom	Ctrl+Shift+Z	Zoom the pane (stack layout) and back
✕	Ctrl+Shift+W	Close the pane (asks when a job is running)

Ordinary +→ and +↓ clicks split the clicked pane right or below. Shift-clicking (or Ctrl+Alt+Shift+R / Ctrl+Alt+Shift+D) adds a full-height column at the tab's right edge or a full-width row at its bottom, respectively, scaling the existing layout while preserving its proportions. Move between terminals with Alt+arrow keys (or Alt+Shift+arrow keys), jump to one with Alt+1 … Alt+9, or pick one by label with Ctrl+Shift+Space. New terminals inherit the clicked pane's working directory. Only the "Codex below" launcher button is removed; running Codex panes and their title badges remain unchanged.

Reload without restarting: press Ctrl+Shift+F5 to reload configuration and refresh cached pane controls. When upgrading from the previous default binding, press it twice: the first reload installs the new binding; the second refreshes the title bars. Existing panes and running jobs remain open. Reload also releases cached pointer backends so native-pointer fixes take effect without restarting the terminal.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗