Skip to content

THE SUMMONOS FIELD GUIDE

The Mac.
Agent-ready.

Connect your agent. Make something native. Know what you can change—and what you can undo.

Get started Explore the toolkit

Native Swift macOS 15+ Your choice of agent

A LITTLE CONTEXT GOES A LONG WAY
01 — KNOW YOUR MACsummon context
02 — PREVIEW THE CONNECTIONsummon connect --dry-run
03 — FIND YOUR RECOVERY POINTSsummon checkpoint list
Read-only commands. A good place to begin.
BUILT IN THE OPEN

0.2.5 preview. See what shipped

A PLACE FOR EVERY START

What brings you here?

All documentation
01

Make yourself at home.

Install SummonOS, choose your agent and get the permissions right.

Set up your Mac
02

Find your next command.

Mac context, themes, checkpoints and the tools behind the panel.

Explore what’s possible
03

Build something native.

From a small idea to a real Mac app, with templates and a clear build loop.

Start building

MEET THE TOOLKIT

Two tools.
One Mac.

A native place to summon your agent. A precise way to change supported settings.

Summon

The menu bar app, CLI and agent connection.

macctl

Typed macOS settings, snapshots and scoped recovery.
Settings catalog Apps & plugins

LESS HUNTING. MORE DOING.

Straight to the useful part.

Something not working?Permissions, connections and updates Understand the boundaries.Agent authority and what undo covers Catch up on the changes.Published previews and branch work Make it better with us.Source, checks and contribution workflow

BEHIND THE DECISIONS

Not just the how.
The why, too.

Design notes, architecture and dated evidence. A working knowledge base—not a promise that every old plan shipped.

Native Mac design Architecture decisions Research notes Plans & reports

Agents run with your permissions. Checkpoints are not a full-system backup.