Skip to content

Repository files navigation

Zenban

Zenban

A kanban board for macOS where every card is a real workspace.

image

Drop a card into To Do, pick an agent, and agent opens up inside the card's own git worktree. Keep working. When the agent finishes the job, the card slides over to In Review on its own. Dev server, browser preview, file browser, git diff, all already living inside the card.

What you get

  • Three column board with drag and drop, pinning, and per board defaults.
  • A dedicated git worktree per card on branch card/<uuid>, created on demand, cleaned up on delete.
  • An embedded Ghostty terminal in every card, backed by a persistent Zellij session.
  • Per board dev server with package manager detection, live logs, and a built in browser preview.
  • Desktop notifications that move cards between columns when your agent reports back.
  • Finder service: "New Zenban Workspace Here".

Shortcuts

Keys Action
Cmd+Shift+A New card
Cmd+Shift+E Delete card
Cmd+Shift+S Toggle dev server
Cmd+Shift+C Commit in Git Changes, DevTools in preview
Cmd+Shift+R Refresh preview
Cmd+Shift+T Fullscreen the focused terminal

Build

open zenban.xcodeproj

Or from the shell:

xcodebuild -project zenban.xcodeproj -scheme zenban -configuration Debug build
xcodebuild -project zenban.xcodeproj -scheme zenban test

Needs macOS 15.6 and Xcode 26.2.

Built on the shoulders of

  • cmux powers the embedded terminal stack, Ghostty workspaces, browser surface, notifications, and the bundled CLI helpers.
  • CodeEdit (CodeEditSourceEditor, CodeEditLanguages, CodeEditTextView, CodeEditSymbols) drives the in-card file browser and source viewer.
  • aizen is where the file browser layer and a handful of utilities were first shaped before landing here.

About

macOS Kanban board with embedded terminals for managing AI coding agents. Each card gets its own terminal session with Claude Code, Codex, or Gemini integration, git worktree isolation, and dev server preview.

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages