Install Quil.
One static binary per platform. No daemon to configure, no database to provision, no cloud account. Works on your laptop, in a container, or on a hardened server.
One-liner install
Installs the latest signed binary into /usr/local/bin. Works on Intel and Apple Silicon.
# macOS (Intel or M-series) curl -sSfL https://raw.githubusercontent.com/artyomsv/quil/master/scripts/install.sh | sh
Verify & launch
Check the version, then spin up your first workspace.
quil --version # quil 1.15.1 (darwin/arm64) quil # workspace opens in your current terminal
One-liner
Works on any glibc-based distro (Ubuntu, Debian, Fedora, Arch). Installs to ~/.local/bin.
curl -sSfL https://raw.githubusercontent.com/artyomsv/quil/master/scripts/install.sh | sh Systemd user service (optional)
Keeps the daemon alive across login sessions.
quil daemon --install-user
systemctl --user start quild Download the zip
Native Windows binary. No WSL required. Uses ConPTY + Named Pipes.
# PowerShell iwr -Uri https://github.com/artyomsv/quil/releases/latest/download/quil-windows-amd64.zip -OutFile quil.zip Expand-Archive quil.zip -DestinationPath $env:LOCALAPPDATA\Quil
Add to PATH
Then launch from any terminal — Windows Terminal recommended.
setx PATH "$env:PATH;$env:LOCALAPPDATA\Quil" # restart terminal quil --version
Tip: F8 for clipboard paste
Windows Terminal eats Ctrl+V before the TUI sees it. Use
F8 instead (or Ctrl+Alt+V) for
the clipboard image proxy.
Go install
Builds from the master branch tip. Requires Go 1.25+.
go install github.com/artyomsv/quil/cmd/quil@latest go install github.com/artyomsv/quil/cmd/quild@latest
Clone & build
One Docker run produces all six binaries (production, dev, debug × client, daemon).
git clone https://github.com/artyomsv/quil.git cd quil ./scripts/dev.sh build
Run tests
go test ./... # PASS · 47 tests
Build variants
quil · quild
Production binaries. Stripped symbols, normal log level, data in ~/.quil/.
quil-dev · quild-dev
Auto dev mode (.quil/ next to the binary), debug logging — no flags needed. The recommended daily-driver for contributors.
quil-debug · quild-debug
Debug logging against the production ~/.quil/ directory — for diagnosing a live issue without switching data dirs.
Remove Quil
Remove the binaries and (optionally) wipe local state. The second command is irreversible — your tabs, panes, notes, and saved AI session IDs will be gone.
sudo rm /usr/local/bin/quil /usr/local/bin/quild # Optional — removes ALL workspace state, ghost buffers, plugin configs rm -rf ~/.quil