Skip to content

Install

ket is in beta. Download the signed build from the download page, open the disk image and drag ket into Applications. Or install it with Homebrew, which also puts the ket command on your PATH:

brew tap ketapp/tap
brew trust ketapp/tap
brew install --cask ket
  • A Mac with Apple silicon, on macOS 13 (Ventura) or later. ket bundles Chromium for its browser tabs, and Chromium needs macOS 13. ket doesn’t run on Intel Macs, and there is no Windows or Linux version.
  • git on your PATH. ket runs git for every worktree, diff and merge.
  • At least one coding agent, installed on its own. ket doesn’t bundle an agent. It starts the one you already use, the same way you would from a terminal. See Agents for how ket finds them.

To check a machine from the command line, ket doctor reports what’s missing. git is the only hard requirement.

ket opens a 1200×780 window in the dark Desk theme. After that it reopens where you left it.

With no projects yet, the window shows Add Project and two hints: ⌘K for the command palette and ⌃` for a terminal. Continue with Add a project.

When it launches, ket adds a few settings so agents can report their status back to it:

  • Agent hooks. ket installs lifecycle hooks for Claude Code (~/.claude/settings.json), Codex (~/.codex/hooks.json) and Grok (~/.grok/hooks/ket.json, if ~/.grok exists), and a plugin for OpenCode (~/.config/opencode/plugin/ket.js). They let the sidebar show when an agent is thinking, running a tool, or waiting on you. In Claude Code’s and Codex’s files ket merges its entries with yours and backs the file up first; for Grok and OpenCode it writes a file of its own. The change is reversible.
  • Claude’s status line. ket wraps the status line in ~/.claude/settings.json and keeps the one you had inside it.
  • Branch pushing. When a repository has a remote, creating a worktree sets push.autoSetupRemote=true in that repository’s local git config, so a new branch pushes without extra flags.
  • Microphone and Speech Recognition, the first time you dictate a prompt. See Quick prompt.