Knot documentation

Knot is a desktop workspace that runs a team of AI coding agents, each in its own terminal or conversation panel, and lets them coordinate through a local MCP server. This is the latest documentation.

Getting started

• Installation - download or build Knot, and the macOS quarantine and signing notes.
• Workspaces - create a workspace, open its window, and use the dashboard and Command Center.
• Agents - add an agent, pick a type, and work with its lifecycle, status, and conversation panel.

Using Knot

• Coordination - how agents register, message one another, plan tasks, and use the MCP tool catalog.
• Git and worktrees - review and commit an agent’s changes, create worktrees, track pull requests, and hand issues and OpenSpec changes to agents.
• Settings - the settings window, appearance, notifications, Autopilot, import, and the app’s other windows.
• Autopilot - classify idle agents and decide when to ask, mark, auto-continue, or use a custom prompt.
• Personas and prompts - persona and prompt libraries, startup prompts, and prompt variables.

Reference

• Agent CLI arguments - the flags each supported coding-agent CLI takes.
• Agent shells - shell agents and the KNOT_AGENT environment.
• Keybindings - the keyboard shortcuts and how to change them.

Select a release from the version picker when working with an earlier build.