Tkzmux — Development skill for Claude Code

tkzmux

A native macOS session manager for [Claude Code](https://claude.com/claude-code). Every Claude Code conversation gets its own real terminal in one window. A sidebar lists the sessions grouped by repository, and each row shows a status derived from Claude Code's own session descriptors and hooks: *working*, *done*, or **NEEDS YOU** when a permission prompt or an unattended answer is waiting. The terminal is a from-scratch Metal renderer driving [libghostty-vt](https://github.com/ghostty-org/ghostty), the project's only third-party dependency. Sessions survive a quit: screen and scrollback are snapshotted, and a restored row reopens under a fresh shell with `claude --resume` a keystroke away.

Status

A personal project, built for one person's workflow, developed in the open. It is **not a supported product**: no roadmap, no compatibility promise, no commitment to answer issues. Use it if it helps you, fork it if it nearly does.

Requirements

• macOS 26 (Tahoe) or later, Apple Silicon only.
• Claude Code installed and working in your shell.
• zsh, bash or fish as your login shell, for the shell integration.
• Optional: the GitHub CLI (gh), authenticated, for the PR badge.

Install

brew tap tkz0/tap
brew trust --cask tkz0/tap/tkzmux
brew install --cask tkzmux

Since Homebrew 6.0 a cask from a third-party tap must be trusted before it is loaded; without the `brew trust` step, `brew tap` fails with `invalid syntax in tap!`. See [Tap Trust](https://docs.brew.sh/Tap-Trust). The app is signed with a Developer ID and notarized, so it opens with no Gatekeeper prompt.

Build from source

git clone https://github.com/tkz0/tkzmux
cd tkzmux
make app            # release build, ad-hoc signed → build/tkzmux.app
open build/tkzmux.app

Everything else is plain SwiftPM, no `.xcodep