Quil – a reboot-proof terminal multiplexer that resumes AI sessions

Notifications You must be signed in to change notification settings

Fork 0

Star 5

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

237 Commits

237 Commits

.claude

.claude

.github

.github

cmd

cmd

docs

docs

internal

internal

scripts

scripts

site

site

techdebt

techdebt

tools/imgproc

tools/imgproc

winres

winres

.dockerignore

.dockerignore

.editorconfig

.editorconfig

.gitignore

.gitignore

.goreleaser.yml

.goreleaser.yml

CHANGELOG.md

CHANGELOG.md

CONTRIBUTING.md

CONTRIBUTING.md

Dockerfile

Dockerfile

LICENSE

LICENSE

Makefile

Makefile

README.md

README.md

THIRD_PARTY_LICENSES.md

THIRD_PARTY_LICENSES.md

VERSION

VERSION

go.mod

go.mod

go.sum

go.sum

package-lock.json

package-lock.json

Repository files navigation

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.

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.

Resize with the mouse Right-click pane menu

Drag any split border — nested panes clamp to minimums, PTYs see one resize on release. Per-pane actions under the cursor: history, notes, lazygit, attention pin, restart, close.

Command palette: jump anywhere …and run anything

Alt+Shift+P fuzzy-finds every pane and tab — navigation grouped at the top. Every action grouped below, each showing its keybinding; type to filter instantly.

…and search inside every pane Jump to the match

Start typing and the palette also searches every loaded pane's scrollback — match counts + a preview under Found in panes. Enter on a pane match jumps straight to it. Searches loaded panes; lazily-restored panes appear once you open them.

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.

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.

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.

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

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

Topics

Resources

Readme

MIT license

Contributing

Contributing

Activity

Stars

5 stars

Watchers

0 watching

Forks

0 forks

Report repository