quil

README

Quil

The persistent workflow orchestrator for AI-native development.

---

A terminal multiplexer built for developers who orchestrate 5–10 sessions per project across AI assistants, build watchers, webhook tunnels, and SSH connections. Unlike tmux, Quil understands projects and typed panes: it persists your entire workspace across reboots, auto-resumes AI conversations by session id, and lets your AI assistant drive your terminal over MCP.

Type quil after a reboot — every tab, pane, working directory, layout split, and AI conversation is right where you left it.

Install

Linux / macOS — one-line install (detects OS+arch, verifies SHA-256):

curl -sSfL https://raw.githubusercontent.com/artyomsv/quil/master/scripts/install.sh | sh

Windows — download quil-windows-amd64.zip from Releases, extract anywhere on PATH.

Go users:

go install github.com/artyomsv/quil/cmd/quil@latest
go install github.com/artyomsv/quil/cmd/quild@latest

Full install options + build-from-source — see docs/installation.md.

Quick start

quil          # launches the TUI, auto-starts the daemon

Five keys to remember:

Key	Action
F1	Menu — Settings, Plugins, Memory, log viewers
Ctrl+N	New typed pane (Claude Code, OpenCode, shell, …)
Ctrl+T	New tab
Ctrl+W	Close active pane
Ctrl+Q	Quit (workspace persists)

That's enough to start. See docs/quick-start.md for the first-launch walkthrough and docs/keybindings.md for the full keymap.

Let your AI assistant drive Quil

Add this to your AI client's MCP config (Claude Desktop, Claude Code, Cursor, VS Code Copilot):

{
  "mcpServers": {
    "quil": {
      "command": "quil",
      "args": ["mcp"]
    }
  }
}

Restart the client. The AI can now list_panes, read_pane_output, send_to_pane, watch_notifications, screenshot_pane, and 12 more tools. Read the build pane and react to errors without copy-paste.

Full guide: docs/mcp.md.

Documentation

Topic	Doc
Installation	installation.md
First launch	quick-start.md
All features	features.md
Keybindings	keybindings.md
Configuration	configuration.md
MCP (AI integration)	mcp.md
Custom plugins	plugin-reference.md
Troubleshooting	troubleshooting.md
Architecture (24 ADRs)	architecture.md
Roadmap	roadmap.md

The full doc index lives at docs/README.md.

Contributing

See CONTRIBUTING.md for branch / commit conventions and the development workflow. Bug reports and PRs welcome.

License

MIT — Copyright (c) 2026 Artjoms Stukans