Skip to content

artyomsv/quil

Repository files navigation

Quil

The persistent workflow orchestrator for AI-native development.

License: MIT Go Platform MCP


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

About

Quil is a persistent workflow orchestrator / terminal multiplexer for AI-native developers.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors