Saggar documentation
Saggar keeps projects, sessions, and coding agents organized around one question: which session needs me right now?
Choose a path
Supporting promises
Knowing which session needs you is the central promise. These supporting promises connect the rest of Saggar to the work you want to do.
| Promise | How Saggar supports it |
|---|---|
| Show the agent what you mean | Image annotations and file attachments on the initial task give the agent concrete context. |
| See what you're working with | File previews and links into your editor, plus image-placeholder previews, let you inspect what a session refers to. |
| Act when the thought occurs | Queued prompts, quick runs, and the command palette let you capture the next instruction or run a command while work continues. |
| Keep your place as work grows | Project organization, monitors, session previews, and restoration keep the workspace together; attention cards bring decisions to you. |
| Stay involved away from the desk | Companion inspection and remote responses let you check in from your phone with the access you approve on the Mac. The Mac must be awake, online, and running Saggar. |
Find an answer
- Status and triage, Agents, and the Security model explain why Saggar behaves as it does.
- Projects and sessions, Pairing a device, and Settings cover configuration.
- Keyboard shortcuts, Project commands, and the rest of the reference record exact values.
- FAQ and Troubleshooting answer the common problems.
- Tips collects the small interactions that are easy to miss.
The one question
A test can fail, a long command can finish, or an agent can wait on a permission prompt. The expensive part is usually not the wait but failing to notice. Saggar classifies each session, folds away what can wait, and builds one queue from everything that needs a decision.
The docs use the same vocabulary as the app: a project is a codebase, a session is one managed terminal session, and triage is the walk through sessions with a claim on you. Start with Status and triage when that vocabulary is new.