Documentation
Features
Everything that ships in toowl today — rendering, tabs, Claude, and polish.
Rendering & performance
- GPU-accelerated wgpu pipeline — cell, underline, glyph, and cursor passes per pane; chrome pass for overlays and the tab strip.
- 120fps-capable where the display allows; cursor smooth-glide only while moving (0 FPS at rest).
- HiDPI-aware font rasterization via cosmic-text + swash; bundled JetBrains Mono, Fira Code, Cascadia Code, IBM Plex Mono.
- Color emoji via swash COLR/CPAL fallback.
- Truecolor + 256-color ANSI — vim, htop, lazygit, Claude Code, all work.
Window & chrome
- 17 built-in themes — Catppuccin Mocha default; OS title bar follows theme.
- Translucent windows — configurable opacity; compositor-aware alpha blending.
- Native chrome — Windows Mica/Acrylic + rounded corners; macOS AppKit runloop with NSAppearance.
- Tab strip — pills with process labels, live hover preview on background tabs, split indicators.
- BSP pane splits — vertical splits, focus ring on active pane, dimmed inactive panes.
Terminal essentials
- 10k-row scrollback (configurable) with mouse-wheel navigation.
- Drag selection with rounded corners; copy/paste via clipboard.
- Hyperlinks — OSC 8 links are underlined and clickable.
- Reflow on resize on the main screen; alt-screen apps (vim, less) keep truncation semantics.
- Process-running confirmation before closing panes with active jobs.
Overlays & UX
- Command palette — fuzzy action search with bound shortcuts shown inline.
- Visual keybinding editor — rebind from the palette; saves to config.toml.
- Settings panel — theme, opacity, font size, cursor style with live preview.
- Context menu — right-click for copy, paste, select, search, reset.
- Confirm dialogs — theme-aware, multi-line body text.
Claude & Feathers
- Claude Feather — session list on the Perch with last-prompt labels and a
livebadge on running sessions. - Crash recovery — one-key resume when Claude exits unexpectedly.
- Kitty inline graphics — APC parser + GPU textured quads.
- macOS Liquid Glass — native AppKit titlebar integration.
- the Aviary — install community Feathers with
feather-install.sh. - Nest, MCP Hub, Scout — first-party Feathers on the Perch.
- Subprocess Feather loader — JSON-RPC plugins from
~/.config/toowl/plugins/. - Hot reload — enable/disable Feathers without restarting (Settings + Feathers… manager).
Roadmap. Per-cell ligature shaping in the glyph atlas remains deferred. Star the repo for updates.