How artyomsv/quil works
Quil is a persistent, project-aware terminal multiplexer for coordinating local and remote development sessions, including AI assistants. The main workflow starts at the quil CLI, enters the TUI, sends workspace actions over IPC to the daemon, and runs commands in managed panes. MCP exposes terminal control to AI agents. The graph also preserves documented worktree, sandbox, session-resume, and workspace-restoration capabilities. Some feature nodes use their exact enclosing directory because their implementation was not sampled; those links are included only where the README documents the relationship.
Main entry points: daemon Daemon services · tui Terminal UI · main.go CLI entry · session.go Workspace sessions
Components 20
Client experience
- CLI entry
cmd/quil/main.go - Terminal UI
internal/tui
Workspace runtime
- IPC transport
internal/ipc/server.go - Daemon entry
cmd/quild/main.go - Daemon services
internal/daemon - Workspace sessions
internal/daemon/session.go - Pane processes
internal/pty/session.go
Agent integration
- MCP tools
cmd/quil/mcp_tools_tasks.go - Agent hooks
internal/claudehook/runhook.go - Hook event ledger
internal/hookevents/ingest.go - Delegated tasks
internal/daemon/task.go
Remote execution
- Remote transport
internal/transport - Remote setup
internal/remoteinstall/source.go
Workspace capabilities
- Persisted workspace
internal/persist - Git worktrees
internal/gitworktree - Command sandbox
internal/sandbox/sandbox.go - Agent notifications
internal/notify - Typed pane plugins
internal/plugin
Other components
- Developer
- AI assistant
Connections 18
- Developer → CLI entry: launches
README.md - CLI entry → Terminal UI: starts
cmd/quil/main.go - Terminal UI → IPC transport: sends requests
internal/tui/router.go - Daemon entry → Daemon services: starts
cmd/quild/main.go - Daemon services → IPC transport: serves clients
- Daemon services → Workspace sessions: manages
internal/daemon/session.go - Workspace sessions → Pane processes: runs panes
internal/daemon/session.go - AI assistant → MCP tools: invokes tools
README.md - MCP tools → IPC transport: requests tasks
cmd/quil/mcp_tools_tasks.go - Workspace sessions → Persisted workspace: restores workspace
- Agent hooks → Hook event ledger: records events
internal/claudehook/runhook.go - Terminal UI → Git worktrees: requests worktrees
internal/tui/worktree_client.go - Daemon services → Command sandbox: runs isolated panes
- Terminal UI → Remote transport: connects hosts
README.md - CLI entry → Remote setup: sets up hosts
- Daemon services → Agent notifications: signals attention
- Daemon services → Typed pane plugins: loads pane types
- MCP tools → Delegated tasks: delegates tasks
cmd/quil/mcp_tools_tasks.go