Documentation
Overview
toowl is a GPU-accelerated terminal with the Claude Feather built in. Start here.
toowl (pronounced /tuːl/, like "tool") is a cross-platform terminal emulator written in Rust. It renders through wgpu, ships with 17 built-in themes, and includes the Claude Feather — first-class Claude Code integration on the Perch from day one.
New here? Install with one command, then open the Perch.
$ curl -fsSL https://toowl.dev/install.sh | sh Vocabulary
| Term | Meaning |
|---|---|
| the Perch | Left sidebar where Feathers render. Toggle with Ctrl+B / Cmd+B. |
| Feather | An extension (plugin). In-process or subprocess, capability-gated, hot-installable. |
| Claude Feather | First-party Feather for Claude Code — session list, crash recovery, palette commands. |
| the Aviary | Feather registry — feather-install.sh, verify, publish. |
Guides
- Getting started Install toowl on macOS, Linux, or Windows and open your first session.
- Features Tabs, splits, GPU rendering, themes, and everything that ships today.
- FlyTo Unified fuzzy navigator for directories, files, git branches, and bookmarks.
- Configuration config.toml reference — appearance, scrollback, keybindings, plugins.
- Keybindings Default shortcuts on Linux and macOS, plus how to rebind.
- Workspaces Daemon-backed named windows — open, detach, and reattach with one command.
- Remote machines Connect to remote toowld daemons over SSH or WebSocket from any client.
- TUI client Run toowl on headless servers and over SSH with tmux-style keybindings.
- Persistent sessions Keep terminal sessions alive across toowld restarts — crash, OOM-kill, or redeploy — as long as the host stays up.
- Feathers The Perch, the Claude Feather, and how to build your own extensions.
- Feather authoring Build a subprocess or in-process Feather plugin.
- MCP Hub Connect Model Context Protocol servers through the MCP Hub Feather.
- the Aviary Install and publish Feathers from the registry.
- Wire protocol JSON-RPC reference for subprocess Feathers.
- Nest Cwd file browser in the Perch.
- Scout SearXNG web search from the Perch.
- Startup performance Cold-start targets, deferred init, and how we benchmark launch speed.
Source & support
- GitHub repository — issues, PRs, design docs in
plans/ - Releases — pre-built binaries for macOS, Linux, Windows
- hi@toowl.dev — questions and feedback