{"slug": "summonos-an-omarchy-inspired-macos-environment", "title": "Summonos: An omarchy-inspired macOS environment", "summary": "Developer RohiRIK released SummonOS, an experimental macOS environment that makes a coding agent a built-in part of the system rather than a browser guest, installable via a curl script on macOS 15+ with Xcode or Command Line Tools and Swift 6. SummonOS bundles Summon, a single agent summoned from anywhere with the ⌃⌥⌘A shortcut or the ⌃⌥Space menu that takes a checkpoint before each session and hands the Mac's crashes and hangs to the agent, plus macctl, a CLI that reads, sets, diffs, applies and undoes macOS settings with a snapshot before every change. The project's author describes it as \"an idea in progress, not a finished product\" and directs users to a security and recovery model document before enabling unattended agents.", "body_md": "*Powered by caffeine and questionable life choices.*\n\nSummonOS is an experiment in what a Mac feels like when an agent is part of the system, not a guest in a browser tab. You summon one coding agent from anywhere. The Mac hands it crashes and hangs. It takes a checkpoint before each session, with recovery for supported settings and successfully captured config files. It changes system settings through a CLI that snapshots every change, and when you need a small tool, it builds a real native app in Swift that launches instantly and works offline.\n\nIt is an idea in progress, not a finished product. Parts of it work today; plenty does not.\nRead the [security and recovery model](https://github.com/RohiRIK/SummonOS/blob/main/docs/security-model.md) before enabling unattended agents.\n\nOn a Mac with macOS 15+ and Xcode (or the Command Line Tools) with Swift 6:\n\n```\ncurl -fsSL https://raw.githubusercontent.com/RohiRIK/SummonOS/main/install.sh | bash\n```\n\nOr let your agent do it. Paste this into Claude Code, Codex or any coding agent on your Mac:\n\n```\nInstall SummonOS by following https://raw.githubusercontent.com/RohiRIK/SummonOS/main/docs/install-ai.md\n```\n\nThe installer builds Summon and macctl from source, puts `Summon.app` in `~/Applications` and `summon` and\n`macctl` in `~/.local/bin`, then runs `summon doctor`. Run it again to update. Then:\n\n```\nsummon default agent claude                               # or codex, opencode, agy, pi, ...\nsummon agent prompt \"summon, give my Mac a calm dark theme\"\n```\n\n|  | **[Summon](https://github.com/RohiRIK/SummonOS/blob/main/incubator/summon/README.md)** | One coding agent you summon from anywhere (⌃⌥⌘A, or the Summon menu on ⌃⌥Space). Crashes and hangs are handed to it, every session starts with a checkpoint you can undo, recurring tasks run while you are away, and it builds apps, themes, wallpapers and icons from templates. | \n|  | **[macctl](https://github.com/RohiRIK/SummonOS/blob/main/macctl/README.md)** | The CLI agents use to read, set, diff, apply and undo macOS settings (Dock, Finder, keyboard, appearance, wallpaper), with a snapshot before every change. | \n|  | **[Agent skills](https://github.com/RohiRIK/SummonOS/blob/main/.claude/skills)** | How agents here plan, design, build and verify native Mac apps: `MacAppArchitecture` ,`MacUX` ,`LiquidGlass` , five historical design styles,`MacAppBuild` ,`PortLinuxWidget` ([which one when](https://github.com/RohiRIK/SummonOS/blob/main/AGENTS.md#skills-which-one-when) ). | \n\nEvery feature, command by command: [`docs/features.md`](https://github.com/RohiRIK/SummonOS/blob/main/docs/features.md).\n\nReal apps, each in its own repo, built by agents with the SummonOS skills and Summon's templates.\n\n|  | App | What it does | \n|---|---|---|\n|  | **[mac-breathe](https://github.com/RohiRIK/mac-breathe)** | A breathing guide: a soft orb grows and shrinks with your breath, from the menu bar or as a full-screen focus window. | \n|  | **[mac-calendar](https://github.com/RohiRIK/mac-calendar)** | Menu bar calendar with your events, reminders, natural-language Add Event and Hebrew dates. | \n|  | **[mac-network](https://github.com/RohiRIK/mac-network)** | Wi-Fi, latency, throughput and IP settings from the menu bar. | \n|  | **[end-of-day](https://github.com/RohiRIK/end-of-day)** | Closes your work apps when the workday ends: a schedule, a 30-second countdown you can snooze, and a streak. Made with `summon project new` . | \n\nI spent a while living in [Omarchy](https://omarchy.org) on Linux, where the whole desktop is one opinionated,\nkeyboard-first experience you can reshape in minutes. SummonOS asks what that feels like on a Mac when the\ncenter of the experience is an agent, and what happens to \"apps\" when making a small one takes minutes.\nMore on how it started: [rohi-lab.org/blog/omarchy](https://rohi-lab.org/blog/omarchy).\n\nEach step names the skill or script that owns it: [`docs/workflow.md`](https://github.com/RohiRIK/SummonOS/blob/main/docs/workflow.md).\n\nIssues, ideas and pull requests are welcome, from people and from agents. Start with\n[`CONTRIBUTING.md`](https://github.com/RohiRIK/SummonOS/blob/main/CONTRIBUTING.md); the rules every agent follows are in [`AGENTS.md`](https://github.com/RohiRIK/SummonOS/blob/main/AGENTS.md).\nSecurity problems go privately through [`SECURITY.md`](https://github.com/RohiRIK/SummonOS/blob/main/SECURITY.md).\n\n```\ngit clone https://github.com/RohiRIK/SummonOS && cd SummonOS\n./install.sh                     # builds and installs this checkout\ntools/check-workspace.sh         # the checks a pull request must pass\n```\n\n| Path | What it is | \n|---|---|\n| [`install.sh`](https://github.com/RohiRIK/SummonOS/blob/main/install.sh) | The one-line installer (Summon + macctl); agents use [`docs/install-ai.md`](https://github.com/RohiRIK/SummonOS/blob/main/docs/install-ai.md) | \n| [`incubator/summon/`](https://github.com/RohiRIK/SummonOS/blob/main/incubator/summon) | Summon: the menu app, the `summon` CLI, themes, skills, app templates | \n| [`macctl/`](https://github.com/RohiRIK/SummonOS/blob/main/macctl) | The settings CLI, its profiles and tests | \n| [`.claude/skills/`](https://github.com/RohiRIK/SummonOS/blob/main/.claude/skills) | Agent skills for building Mac apps | \n| [`docs/`](https://github.com/RohiRIK/SummonOS/blob/main/docs/index.md) | An [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) bundle:[features](https://github.com/RohiRIK/SummonOS/blob/main/docs/features.md) ,[app lifecycle](https://github.com/RohiRIK/SummonOS/blob/main/docs/workflow.md) ,[tools](https://github.com/RohiRIK/SummonOS/blob/main/docs/tools.md) ,[plans](https://github.com/RohiRIK/SummonOS/blob/main/docs/plans/index.md) ,[research](https://github.com/RohiRIK/SummonOS/blob/main/docs/research/index.md) ,[update log](https://github.com/RohiRIK/SummonOS/blob/main/docs/log.md) | \n| [`tools/`](https://github.com/RohiRIK/SummonOS/blob/main/tools) | Workspace scripts: checks, plugin registry ( `mp` ), publish, release, previews, README art, docs index ([docs/tools.md](https://github.com/RohiRIK/SummonOS/blob/main/docs/tools.md) ) | \n| [`examples/`](https://github.com/RohiRIK/SummonOS/blob/main/examples) | `menubar-starter` , the skeleton new workspace apps start from | \n| [`plugins.json`](https://github.com/RohiRIK/SummonOS/blob/main/plugins.json) | Registry of the workspace apps; [`plugins.md`](https://github.com/RohiRIK/SummonOS/blob/main/plugins.md) is generated from it | \n| [`AGENTS.md`](https://github.com/RohiRIK/SummonOS/blob/main/AGENTS.md) | Rules for agents and people: stack, workflow, conventions, publishing. `CLAUDE.md` points to it. | \n| [`tasks/`](https://github.com/RohiRIK/SummonOS/blob/main/tasks) | `todo.md` (current plan only) and`lessons.md` (rules learned from corrections) | \n\n## **Maintainer setup** (publishing apps to their own repos)\n\nEach workspace app lives in its own pair of repos (private `<name>-dev` + public `<name>`), cloned into\n`plugins/<name>/`, which is gitignored here.\n\n1. Xcode (with the Xcode MCP bridge, `.mcp.json` ) selected via`xcode-select` , and`gh` signed in.\n2. [Bun](https://bun.sh) and`jq` , for`tools/mp` ,`tools/xcode-mcp.ts` and`tools/render-previews.sh` .\n3. `tools/mp clone --all` clones each app's dev repo into`plugins/<name>/` .\n4. Optional: `.claude/skills/MacPluginPlaybook` is a per-machine symlink to a private skills library (gitignored).\n5. Create `tools/private-patterns.txt` (gitignored): one regex per line for private values (email,\nhome subnet, MAC addresses, hostnames).`tools/publish-public.sh` refuses to run without it, and`tools/record-demos.sh` uses it to scrub demo transcripts.\n\nBuild caches go to `~/Library/Caches/macplugins/<name>`, never `.build/` inside a synced folder.\n\nThe art in `docs/assets/` is generated, so it stays consistent and renders on GitHub's web and mobile apps:\n\n```\npython3 tools/readme-art.py           # write docs/assets/*.svg (hero, wordmark, diagram, icons, pill, terminal cards)\npython3 tools/readme-art.py --check   # exit 1 if a committed SVG is stale\ntools/record-demos.sh                 # on a Mac: re-record macctl's demo transcripts, cards and GIF\n```\n\nSummonOS uses Summon's ring mark and colors, shared through `incubator/summon/design/brandkit.py`;\nSummon's PNG icon, banner and wordmark are made by `incubator/summon/design/generate.py`. The app screenshots\nunder \"Built with SummonOS\" come from each app's own repo.\n\n[MIT](https://github.com/RohiRIK/SummonOS/blob/main/LICENSE). The vendored skills `swiftui-expert-skill` and `swift-concurrency-pro` are MIT and keep their\nown `LICENSE` files; upstream notices are in each app's `THIRD_PARTY_NOTICES.md`.", "url": "https://wpnews.pro/news/summonos-an-omarchy-inspired-macos-environment", "canonical_source": "https://github.com/RohiRIK/SummonOS", "published_at": "2026-10-20 17:26:28+00:00", "updated_at": "2026-10-20 17:46:46.244115+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "artificial-intelligence"], "entities": ["SummonOS", "RohiRIK", "Summon", "macctl", "Claude Code", "Codex", "Omarchy", "Swift"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/summonos-an-omarchy-inspired-macos-environment", "markdown": "https://wpnews.pro/news/summonos-an-omarchy-inspired-macos-environment.md", "text": "https://wpnews.pro/news/summonos-an-omarchy-inspired-macos-environment.txt", "jsonld": "https://wpnews.pro/news/summonos-an-omarchy-inspired-macos-environment.jsonld"}}