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 live badge 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.