Get started
Install Quil in 30 seconds.
Three ways to get Quil running. Pick the one that fits your
setup — all three produce the same two binaries (quil
and quild) and the same on-disk state under ~/.quil/.
Linux / macOS
One-line install script
The install script detects your OS and architecture, downloads the latest release binary, verifies the checksum, and copies both quil and quild into /usr/local/bin.
curl -sSfL https://raw.githubusercontent.com/artyomsv/quil/master/scripts/install.sh | shGo users
Build from source via go install
If you already have Go 1.25+ installed, install directly from the module path. This compiles both binaries and drops them in $GOBIN.
go install github.com/artyomsv/quil/cmd/quil@latest
go install github.com/artyomsv/quil/cmd/quild@latestWindows
Pre-built .zip from GitHub Releases
Windows uses a native ConPTY backend, not WSL. Download the windows/amd64 .zip, extract it anywhere on PATH, and run quil.exe.
# Download the latest windows-amd64 .zip from:
# https://github.com/artyomsv/quil/releases/latestFirst run
Once installed, launch the TUI. The daemon (quild)
auto-spawns in the background on your first run and opens a
Unix domain socket (or Named Pipe on Windows) at
~/.quil/quild.sock.
quil
You'll see an empty workspace. Press Ctrl+T to
create a new tab, Alt+V or Alt+H to
split panes vertically or horizontally, F2 to
rename a tab, Alt+C to cycle tab colours.
Verify
Check you're running the version you expect:
quil --version
Expected output: quil version 1.0.0 (commit abc1234, built 2026-04-07)
— your commit hash and build date will differ.
Uninstall
Remove the binaries and (optionally) wipe local state:
sudo rm /usr/local/bin/quil /usr/local/bin/quild
# Optional — removes ALL workspace state, ghost buffers, and plugin configs
rm -rf ~/.quilThe second command is irreversible. Your tabs, panes, notes, and saved AI session IDs will be gone. Keep the directory if you want the option to reinstall later.