Documentation
Claude Feather
Run Claude Code inside toowl, a GPU-accelerated terminal emulator. Session list, crash resume, and palette commands on the Perch — no browser detour.
toowl is a GPU-accelerated terminal emulator with a first-party
Claude Feather. Open the Perch and your Claude Code
sessions for this directory are already there: resumable, crash-recoverable,
and wired into the command palette. Bring your own claude
binary; the Feather handles the rest.
This is not a web wrapper. Claude runs in a real PTY pane, with the same GPU renderer, splits, and daemon-backed workspaces as every other toowl session.
Open the Perch
Cmd+B on macOS, Ctrl+Shift+B on Linux (plain
Ctrl+B stays free for tmux and the toowl TUI). The Claude Feather ships enabled in the
free build via toowl-plugin-agent.
What it does
- Session list. Every Claude Code conversation in the
active pane's cwd, labeled by title or last user prompt. The list
watches
~/.claude/projects/. - One-click resume. Click a row to spawn or focus that conversation in the current directory.
- Crash recovery. If Claude exits mid-task, a banner offers R to resume or X to dismiss. Context survives.
- Palette. Cmd+Shift+P / Ctrl+Shift+P searches Claude commands next to terminal actions.
Requirements
Install the Claude Code CLI yourself and keep it on PATH in
your login shell. Apps launched from the macOS Dock inherit a minimal
PATH from launchd — if claude works in a shell but not from
the Dock, see FAQ.
Related
- Feathers — the extension system the Claude Feather is built on.
- Toowl MCP — let Grok or Claude drive toowl sessions over MCP.
- Installation — one-line install of the terminal itself.