Documentation

Sinclair documentation

Sinclair is a fast, GPU-accelerated terminal for macOS and Linux. It pairs a meticulous VT core with tabs, recursive splits, live-reload config, built-in themes, a plugin system, an MCP server, and a local relay for coordinating agent teams. These docs cover all of it.

brew install --cask wess/packages/sinclair

Start here

InstallmacOS (Homebrew), Linux (AppImage/deb/tarball), or build from source. ConfigurationThe config file, every option, and live reload. KeybindingsThe trigger syntax, the full default map, and the action catalog.

Learn by doing

There's a hands-on walkthrough for every part of Sinclair — from your first splits to running a whole team of agents in parallel. Follow one end to end, or browse the full set.

Your first 10 minutesSplits, tabs, themes, and the palette — the fastest path to feeling at home. Organize your workspaceTabs, splits, layouts, sidebars, broadcast input, and session restore. Run an agent teamLaunch a supervisor and workers that message each other over the local relay. All tutorials →Appearance, config, navigation, clipboard, recording, worktrees, agent status, and more.

Using Sinclair

Tabs, splits & layoutsThe workspace model, directional navigation, and saved tile layouts. Command palette & quick openLaunch anything with ⌘⇧P and ⌘P. ProductivityAutosuggestions & completion, hint & copy mode, command blocks, fuzzy pickers (clipboard, snippets, profiles, emoji), triggers, redaction, timestamps, annotations, search, macros, recording, and more. Themes & appearance22 built-in themes, per-color overrides, fonts and cursor.

Extending & agents

PluginsCommand plugins, live IPC panels, webview surfaces, event triggers, agent-callable tools (MCP), and the installable catalog. Plugin tutorialBuild four plugins step by step, plus the full protocol, host capabilities, and publishing. Prompt DesignerDesign your shell prompt visually and apply it to your shell. MCP & automationDrive the terminal from Claude and other MCP clients. Agent meshRun coordinated agent teams over the local relay.

Reference

Terminal coverageWhat the VT core supports and known gaps. CLI referenceThe sinclair subcommands and process modes.

Tip

Every command — built-in or plugin-contributed — is reachable from the command palette (⌘⇧P), so you can always find a feature even if you don't remember its keybinding.