Quil

Quil

The persistent workflow orchestrator for AI-native development.

[](LICENSE) [](https://go.dev) [](#install) [](docs/mcp.md)

---

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](docs/mcp.md).

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

See it

| Survives a full reboot | AI drives your terminal | |:---:|:---:| | | | | Panes, working dirs, and AI sessions snap back in ~30s. | Expose Quil over MCP — agents list panes, read output, send keys. | | Many projects, one window | Typed panes | | | | | Focus mode + a dozen project tabs. | Per-type setup: dir browser, resume strategy, permission toggles. |

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](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](docs/quick-start.md) for the first-launch walkthrough and [docs/keybindings.md](docs/keybindings.md) for the full keymap.

If anything ever hangs: quil restart recovers the daemon (escalating stop → fresh start → tabs restored from the last snapshot), and Alt+R restarts a single stuck pane in place with its AI session resumed.

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](docs/mcp.md).

Built-in integrations

Typed panes ship for the tools developers run all day. Each opens from Ctrl+N; the ones that wrap an external binary appear only when that binary is on PATH (greyed with an install link otherwise).

| Integration | What it is | |---|---| | Terminal | Your system shell (bash/zsh/PowerShell/fish) with live working-directory tracking. | | Claude Code | AI coding session that resumes the exact conversation by session id across reboots. | | OpenCode | AI coding session (opencode) with the same per-pane session resume. | | lazygit | Git TUI (lazygit) for the repo near the pane — also a per-tab Alt+G overlay. | | k9s | Kubernetes cluster TUI (k9s) with a context picker sourced from your kubeconfig. | | lazysql | Database TUI (lazysql) for MySQL, PostgreSQL, SQLite, and MSSQL. | | SSH | Persistent SSH session that re-runs the same command (host, port, forwards) on restart. | | Stripe CLI | stripe listen webhook tunnel that restores its forward URL and surfaces the signing secret. |

Define your own pane types in TOML — see the [plugin reference](docs/plugin-reference.md).

Documentation

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

The full doc index lives at [docs/README.md](docs/README.md).

Contributing

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

License

[MIT](LICENSE) — Copyright (c) 2026 Artjoms Stukans

The Windows build bundles Microsoft's MIT-licensed OpenConsole (OpenConsole.exe + conpty.dll) to host terminal panes correctly on Windows 10. See [THIRDPARTYLICENSES.md](THIRDPARTY_LICENSES.md) for full third-party attribution.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: artyomsv
• Source: artyomsv/quil
• License: MIT
• Homepage: https://quil.cc/

Install and usage instructions live in the source repository linked above.