Skip to main content

Documentation

Saggar is a native macOS terminal manager for tending AI coding agents: one window for every codebase, with each terminal wearing its status loudly. Remote control is one part of it — a small server inside the app that answers the same question from your phone — and it is off until you arm it.

The one question

Every part of the app is arranged around which terminal needs me right now? Agents work for minutes at a time and then stop dead on a permission prompt, and the cost of that is never the waiting — it is not noticing. So sessions classify themselves from their own output, the menu sorts and folds itself around what is loudest, and one key walks you through everything with a claim on you. When a feature does not help answer that question, it tends not to be here.

The vocabulary

Project

A codebase you have open — a directory, usually a git repository. Projects live on the left menu; everything else hangs off them.

Session

One terminal inside a project: a real login shell, usually with an agent running in it. Sessions carry a status, an agent, and git state.

Status

One of four bands, decided from what the shell prints: needs you, working, idle, finished. The whole app is arranged around surfacing the first.

Agent

A coding CLI running inside a session — Claude Code, Codex, or another. Saggar recognizes them whether or not it started them, and can install an opt-in handshake that replaces guessing with a contract.

Triage

The walk through every terminal with a claim on you, loudest first. ⌘J is the whole feature.

Commands

A markdown file a project commits, listing the commands that repo actually needs. Saggar turns it into buttons — and, in its startup section, into the set of terminals a project opens with.

Remote control

A small HTTP server inside the Mac app, off by default, that serves this companion and answers a narrow control protocol.

Grant

What a paired device holds: a token scoped to a capability tier, kept in the Mac's login Keychain and revocable there.

Pages