Read the source.
Quil's docs live on GitHub next to the code — README, VISION, PRD, ARCHITECTURE, ROADMAP, plugin reference. This page is a map.
Getting started
Landing page: what Quil is, one-line install, five keys to remember, MCP wiring snippet, link to deep docs.
← OVERVIEWPre-built binary (Linux / macOS one-liner, Windows zip), Go install, build from source with Docker or local Go.
← INSTALLFirst-launch walkthrough — five keys, opening a typed pane, automatic persistence, AI assistant connection.
← FIRST RUNDaemon won't start, MCP not detected, log file locations, force-stop scripts, full reset.
← HELPUsing Quil
Capability tour grouped by area: persistence, layout, typed panes, clipboard, observability, pane notes.
← TOURFull keymap, customization syntax, what to bind and what to leave passing through to the PTY.
← KEYS~/.quil/config.toml reference — every section and every key with defaults and effects.
← CONFIGLet your AI assistant drive Quil. Client wiring for Claude / Cursor / VS Code, all 17 tools, redaction model.
← AIAuthoring & extending
Project context
Why Quil exists, who it's for, and what problem the reboot-proof workspace promise solves.
← PHILOSOPHYClient-daemon model, PTY backends, IPC protocol, state persistence — 24 ADRs covering every meaningful decision.
← INTERNALSOriginal v1 product requirements: personas, user stories, success metrics, scope boundaries. Historical reference.
← SPECMilestone-by-milestone progress through the latest release, plus in-flight polish work.
← PLANSemantic versioning policy driven by Conventional Commits.
← SEMVERKeep-a-Changelog formatted history of every release from v0.1.0 onward.
← HISTORYFuture roadmap PRDs
Fuzzy-search command bar accessible via Ctrl+Shift+P. Future milestone.
← FUTUREA registry + discovery mechanism for user-contributed TOML plugins.
← FUTURERead-only tunnel into a live Quil workspace so a collaborator can watch your panes.
← FUTURELiveness probes per pane with automatic restart policies. Think systemd for pane processes.
← FUTUREImport tmux sessions — read ~/.tmux/resurrect/ and map them into Quil's workspace model.
← FUTUREDeclarative workspace definitions in quil.toml checked into project repos.
← FUTUREReading the source? Start here.
Daemon at cmd/quild/, TUI client at cmd/quil/,
shared internals under internal/. Issues and PRs welcome.