Rapunzel – a tree-style terminal for AI agents
FreeFreeFree tier
About Rapunzel – a tree-style terminal for AI agents
Rapunzel is an open-source, tree-style terminal designed specifically for managing multiple AI agent sessions. It replaces traditional flat terminal tabs with a hierarchical tree of shell sessions, allowing users to organize, rename, move, collapse, and close branches while keeping one active live terminal. Built with pywebview and PTY-backed interactive shells, it persists workspace state to ~/.rapunzel/workspace.json and restores it on launch. Inspired by the Tree Style Tab extension for Firefox, Rapunzel aims to provide a simple desktop surface for agent work without the complexity of a full IDE.
Key Features
Tree-based shell sessions with root and child branches
One active live terminal conversation surface per session
Rename, move, collapse, and close branch actions
PTY-backed interactive shells (POSIX on macOS/Linux, pywinpty on Windows)
Workspace persistence to ~/.rapunzel/workspace.json with restore on launch
Embedded pywebview desktop app with optional macOS app bundle build
Apple Silicon support: Homebrew commands forwarded through native arm64
Pros & Cons
Pros
- Simplifies tracking and organizing many agent sessions hierarchically
- Workspace persistence prevents losing session state on restart
- Free and open-source with no usage limits
- Lightweight and focused on a single purpose rather than a full IDE
- Runs on macOS, Linux, and Windows with native install scripts
Cons
- Early stage project with only 12 commits and few stars on GitHub
- Requires manual setup of Python and Node.js dependencies
- Primarily terminal-based; limited graphical interface for non-technical users
- No built-in integration with popular AI agent frameworks (e.g., LangChain, AutoGPT)
- Documentation and community support are minimal
Best For
Running and tracking multiple long-running AI agent sessionsReplacing traditional terminal tabs when managing numerous concurrent agentsOrganizing agent experiments or workflows with hierarchical navigationLightweight desktop surface for agent work without a full IDE
FAQ
What is Rapunzel?
Rapunzel is a tree-style terminal browser designed for AI agents. It allows users to manage multiple agent sessions in a hierarchical tree instead of flat tabs.
How do I install Rapunzel?
Prerequisites are Python 3 and Node.js. On macOS/Linux run './install.sh' and on Windows PowerShell run '.\install.ps1' from the cloned repo. Then launch with './Rapunzel.command' (macOS/Linux) or '.\Rapunzel.ps1' (Windows).
Does Rapunzel save my sessions?
Yes, workspace state is persisted to ~/.rapunzel/workspace.json and restored automatically when you launch Rapunzel again.
What platforms does Rapunzel support?
Rapunzel supports macOS, Linux, and Windows. On Apple Silicon Macs it wraps Homebrew commands through native arm64 for compatibility.