klause-workflow

Klausemeister

A native macOS terminal + project-management tool + agent orchestrator, built around a simple idea: the path from "here's a Linear ticket" to "PR merged" should be one app — ideally one keyboard shortcut.

Klausemeister pairs a libghostty-powered terminal with a Linear-backed kanban board, git worktree management, and an MCP server that can drive headless Claude Code "meister" agents through a formal workflow state machine. Pick a ticket, spawn a branch + worktree + tmux session, hand it to a meister, watch it cook.

At a glance

The main window hosts three panels that share one detail pane:

• Sidebar — repositories, worktrees (with per-worktree queues), terminal tabs, and meister status dots.
• Detail pane — routes to one of: the kanban board (Meister), a single worktree's swimlane (Worktree detail), or a live terminal tab.
• Inspector (optional, Cmd+L) — Linear ticket details, including Markdown description, labels, and state, rendered inline.

Feature set

Terminal

• GPU-rendered via libghostty's Metal backend — the same VT emulator, font shaper, and PTY stack as Ghostty.app. Klausemeister is a thin Swift shell over libghostty; all the fast stuff is Zig.
• Tabs and window-level IME — full NSTextInputClient bridging for CJK/emoji composition. Key bindings go through performKeyEquivalent so the menu bar and the terminal don't fight over shortcuts.
• Tmux 1:1 with worktrees — every worktree gets its own tmux session. Opening a worktree terminal attaches to that session; closing the tab detaches but keeps the session alive.
• Live config hot-reload — theme switches re-apply libghostty config in place without destroying the surface.

Meister — the kanban board

• Linear issues imported via GraphQL and cached in SQLite (GRDB). Drag cards between workflow states; status changes round-trip back to Linear.
• Team filter — pick which Linear teams show up in the board.
• State mapping — configure which Linear workflow state on each team maps to which kanban column (Backlog / Definition / Todo / Spec / In Progress / In Review / Testing / Done).

Worktrees

• Per-issue git worktrees — assigning an issue to a worktree creates a branch and switches the worktree to it. All through /usr/bin/git — no libgit2, no surprises.
• Inbox → Processing → Outbox queues — each worktree has three swimlanes. Pull an issue into Processing to start work; push it to Outbox when done. Returning an issue from a worktree puts it back on the kanban board in the correct column.
• Multi-repo aware — register several repositories; organize worktrees under them.
• Schedule Gantt overlay — visualize scheduled work across worktrees as a gantt strip (MVP).
• Swimlane actions — inline buttons per lane to advance the workflow (Define / Execute / Review / Open PR / Babysit / Push) via slash commands injected into the worktree's tmux session.

Meister loop (autonomous agents)

Klausemeister can spawn a headless Claude Code — a "meister" — in each worktree's tmux session. The meister loads the klause-workflow plugin and drives the ticket through a formal state machine:

Pull → Define → Execute → Review → Open PR → Babysit → Push

Each transition is a slash command (/klause-workflow:klause-define, etc.) that maps to exactly one edge in ProductStateMachine. The app coordinates meisters through an in-process MCP server (Unix socket) and a shim (klause-mcp-shim) that bridges Claude Code's stdio transport to the socket. The shim forwards getNextItem, reportProgress, reportActivity, completeItem, etc. straight into the TCA store.

This makes the whole board "pilotable" — kick a card over to a worktree, start a meister, and it will work the ticket end-to-end unless you intervene.

Command palette, shortcuts, inspector

• Command palette (Ctrl+P, or Cmd+Shift+P for VS Code muscle memory) — fuzzy-search every AppCommand. Runs the action directly.
• Shortcut Center (Cmd+,) — view and customize every key binding. Bindings are persisted in UserDefaults and re-read at session start.
• Worktree switcher (Ctrl+K) — quick-jump between Meister and any worktree.
• Inspector (Cmd+L) — slide-out ticket inspector with Markdown-rendered description.
• Debug panel (Cmd+Shift+D) — MCP server state, active shim discovery, connection diagnostics.

Themes

Six theme families with multiple variants each, selectable from the Theme menu: