SummonOS docs¶

Everything written down about SummonOS: features, how to install and build, tools, plans and research.

Folders¶

Architecture decisions - Accepted and proposed design decisions, one per file.
Plans and reports - Finished and long plans, one per file. A plan records what was decided at the time; when it disagrees with a project's README or PROJECT-CONTEXT.md, those win.
Research - Research notes behind the skills and the design of SummonOS apps.
macOS UX surfaces - The seven kinds of Mac app surface across 14 UX dimensions, and each one checked against Apple's HIG and API docs (2026-10-25).

Features - Every user-visible feature of Summon, macctl, the SummonOS apps and the workspace tools, in one list.
SummonOS documentation - Your field guide to an agent-ready Mac: set up SummonOS, explore the toolkit and build native apps.
Security and recovery model - Agent authority, checkpoint scope, task isolation, local diagnostics, and release trust boundaries.
Status and verification - Published preview versus unreleased implementation, documentation baseline, and remaining release-acceptance limits.
Workspace tools - What each script in tools/ does and how to run it: installer, mp, local CI, checks, publishing, previews, README art.

Documentation website - Build, preview, maintain, and publish the wiki from canonical repository Markdown without changing Swift dependencies.
Getting started - Install SummonOS, choose an agent, review permissions and connect Mac context safely.
Install SummonOS (for an AI agent) - Step-by-step install, check and report instructions a coding agent follows to install SummonOS on a Mac.
Troubleshooting - Diagnose installation, agent connection, permissions, updates, inventory and theme problems without discarding user state.
App lifecycle - How a SummonOS app goes from idea to public release, and which skill or script owns each step.