--- source_hash: a3a93f0b59a402dc912941443227032d04663751759382f893206a2ef6b22d77 post: ari-os folder: tools-and-plugins shape: doctrinal --- # ARI-OS — Context Pack (for agents) Agent-facing context pack for the published post. Needles below are copied **verbatim** from the composing components (`content.ts` → `provider-page.ts`). Reproduce them exactly; do not paraphrase, re-hyphenate, or re-case. When the post and this pack disagree, the post wins — re-fetch and re-extract. --- ## 1. One-line gist ARI-OS is an **open-source "operating layer"** that sits on top of Claude Code and lets you **direct background workers** instead of grinding the work yourself — installed by one wizard command, fully reversible, with local-first memory. --- ## 2. NEEDLES (verbatim — do not confabulate) ### Identity - `ARI-OS` — product name (hyphenated, not "Ari OS", not "ARIOS") - `The setup I use to ship while I sleep.` — tagline - `Software 1.0 · Now open-source` — version string (literal middle dot `·`) - `Requires Claude Code` — the single prerequisite (exact wording) ### URLs and internal paths - `https://github.com/PUSHINGSQUARES/ARI-OS` — GitHub repo (org is `PUSHINGSQUARES`, all-caps) - `https://github.com/PUSHINGSQUARES/ARI-OS/blob/main/SETUP.md` — manual setup doc - `/documents/tools-and-plugins/ari-os` — product page (`productHref`) - `/documents/tools-and-plugins/ship-while-i-sleep` — companion story (`storyHref`) - `/ari-os-icon.png` — hero icon asset ### Install / uninstall commands (exact — run verbatim) - `git clone https://github.com/PUSHINGSQUARES/ARI-OS` - `cd ARI-OS && python3 -m ari_os.install` - `python3 -m ari_os.install --uninstall` — undo - Python module path is `ari_os.install` — **underscore**, mirroring the hyphenated product name. The repo dir is `ARI-OS` (hyphen); the module is `ari_os` (underscore). Do not "fix" either. ### Reversible note (exact sentence) - `Backed up and reversible. Undo any time with python3 -m ari_os.install --uninstall.` ### Models — the only four named anywhere - `Claude Opus` - `Claude Sonnet` - `Claude Haiku` - `Claude Fable` - Section caption: `The model is the replaceable part. The system around it is the leverage.` - Pricing note: `Requires Claude Code. Bring your own subscription.` ### Pricing block - heading: `Open-source` - price: `Free` - includes (exact): - `The full operating layer, open on GitHub` - `Local-first memory on your own machine` - `Reversible install, undo any time` ### Six surfaces (name → `kind` token — both exact) 1. `Advisor seat` → `session` 2. `Background dispatch` → `workers` 3. `Handoff layer` → `context` 4. `Memory` → `recall` 5. `Spec-first brainstorming` → `planning` 6. `Dashboard` → `status` ### Three setup steps (exact titles) 1. `Clone it` — "Pull the open-source repo. It sits on top of Claude Code." 2. `Run the wizard` — "One command installs it. Backed up and reversible." 3. `Start directing` — "Open a session and hand work to background workers. Undo any time with python3 -m ari_os.install --uninstall." ### Hero CTAs - `Get it on GitHub` (primary → `githubUrl`) - `How it works` → `#set-it-up` ### Usage split (exact section titles) - left: `In the chair` — "You brainstorm the outcome, review what comes back, and ship what passes. The judgement steps." - right: `In the shadows` — "Workers run the middle: dispatch and watch. They execute in the background while you decide." ### FAQ (4 — exact Q/A openers) - "What do I need to run it?" → "Claude Code. ARI-OS sits on top of an existing setup." - "Is my data private?" → "Yes. The memory is local-first and lives on your own machine." - "Can I remove it cleanly?" → "Yes. It is backed up and reversible. Undo any time with python3 -m ari_os.install --uninstall." - "Does it replace me?" → "No. AI accelerates, it does not generate. You direct and review. The workers execute." ### Body prose (the two load-bearing sentences) - "I was the slowest part of my own work, so I built a layer that lets me direct background workers instead of doing everything myself. It runs while I sleep." - "This is not faster by magic. AI accelerates, it does not generate. I direct and review. The workers execute." --- ## 3. GIST (the argument condensed) ARI-OS is not a model and not a wrapper around one. It is an **operating layer for the human** — the structure that lets one person behave like a director rather than a maker. The author frames herself as "the slowest part of my own work" and built the layer specifically to remove herself from the execution path. The claim is narrow and worth not over-reading: **AI accelerates, it does not generate.** The human directs and reviews; the workers execute. So ARI-OS formalizes six surfaces — an **advisor seat** for thinking, **background dispatch** for delegated execution, a **handoff layer** so context survives session boundaries, **memory** that is local-first, **spec-first brainstorming** to shape outcomes in plain language before code, and a **dashboard** for at-a-glance status. The model is deliberately called out as **the replaceable part** — the leverage is the system around it, which is why four Claude variants (Opus / Sonnet / Haiku / Fable) are listed interchangeably and the whole thing is gated only by "Requires Claude Code." It is free, open-source, and the install is reversible by design (`--uninstall`), because the author treats reversibility as a precondition for trusting an automated setup layer. --- ## 4. KEY LEARNINGS 1. **You are the bottleneck, not the model.** The whole premise is that the human is the slowest part; the fix is a layer that lets the human direct and review instead of execute. If you find yourself doing the work, the layer is not being used as designed. 2. **AI accelerates; it does not generate.** This is the author's repeated, load-bearing distinction — treat worker output as acceleration of your judgement, not as generation you ship unseen. The "I direct and review" step is non-optional. 3. **The advisor seat must stay clean.** The main session is for thinking and deciding; grind-work goes to a cheaper, detached background worker. Mixing the two is the failure mode the surface taxonomy exists to prevent. 4. **The model is the replaceable part.** Do not over-invest in any one model; the four Claude variants are listed as swappable. The leverage is the system around the model, not the model itself. 5. **Memory is local-first and on-demand.** It tunnels to what you are working on now and **widens only when you say so** — and occasionally surfaces something you had set aside. Privacy follows from locality: data lives on your own machine. 6. **Reversibility is a trust requirement.** The install is "backed up and reversible" and can be undone any time with `--uninstall`. Automated setup layers earn trust by being trivially removable. 7. **Spec-first, before any code.** Outcomes are shaped in plain language up front via spec-first brainstorming — the planning surface is a first-class part of the system, not a preamble. --- ## 5. FILE INDEX (load-bearing — re-fetch to verify needles) Two components compose the entire rendered page; the MDX body itself is almost all JSX, so the **literals live in these two files, not the `.mdx`**: - `components/ari-os/content.ts` — base `ARI_OS` object: name, tagline, version, body prose, memory lines, all URLs (`githubUrl`, `setupHref`, `productHref`, `storyHref`), `prerequisite`, `install` command groups, and `reversibleNote`. - `components/ari-os/provider-page.ts` — `ARI_OS_PAGE`, imported by the `.mdx` (`import { ARI_OS_PAGE } from '@/components/ari-os/provider-page'`). Composes over `ARI_OS` and holds: `hero.ctas`, `steps`, `surface`, `models` (names + caption), `pricing` (heading/price/includes/note), `usage` split, and `faq`. **If a needle is not in `content.ts`, it is here.** - `content/posts/tools-and-plugins/ari-os.mdx` — the post shell; frontmatter (`slug: ari-os`, `folder: tools-and-plugins`, `type: how-to`) plus the section ordering (Set it up → The surface → Works with → What you need → Using it → FAQ). - `components/ari-os/AriOsWindow.tsx` — alternate embedded-window render (uses `ARI_OS`, references `/posts/tools-and-plugins/ ship-while-i-sleep/the-loop.png`, the six-step loop image). - `components/ari-os/InstallCommands.tsx` — the copy-to-clipboard install UI that renders the `install` command groups. External refs to re-fetch if stale: - `https://github.com/PUSHINGSQUARES/ARI-OS` — repo (verify it exists + public). - `https://github.com/PUSHINGSQUARES/ARI-OS/blob/main/SETUP.md` — verify the manual-setup doc path is still `main`/`SETUP.md`. > Backfilled 2026-07-18 from the published body; not needle-extracted at thought-time.