📄 ari-os.md15/06/2026
Documents › tools-and-plugins

ARI-OS: set it up and use it

ARI-OS

ARI-OS

The setup I use to ship while I sleep.

Software 1.0 · Now open-source

Get it on GitHubHow it works

Set it up

  1. Step 1

    Clone it

    Pull the open-source repo. It sits on top of Claude Code.

    $ git clone https://github.com/PUSHINGSQUARES/ARI-OS
  2. Step 2

    Run the wizard

    One command installs it. Backed up and reversible.

    $ cd ARI-OS && python3 install.py
  3. Step 3

    Start directing

    Open a session and hand work to background workers. Undo any time with python3 install.py --uninstall.

The surface

  • Advisor seatsessionYour main session stays for thinking and deciding, not grinding through the work.
  • Background dispatchworkersHand a defined task to a cheaper worker that runs on its own, detached from your session.
  • Handoff layercontextContext survives when a session ends, so the next one starts without losing the thread.
  • MemoryrecallRemembers across sessions on your own machine, and pulls the right past context back.
  • Spec-first brainstormingplanningYou shape the outcome in plain language before any code gets written.
  • DashboardstatusOne glance shows what is running, what finished, and what is stuck waiting on you.

Works with

Claude Opus
Claude Sonnet
Claude Haiku
Claude Fable

Requires Claude Code

The model is the replaceable part. The system around it is the leverage.

What you need

Open-source

Free
  • The full operating layer, open on GitHub
  • Local-first memory on your own machine
  • Reversible install, undo any time

Requires Claude Code. Bring your own subscription.

Using it

In the chair

You brainstorm the outcome, review what comes back, and ship what passes. The judgement steps.

In the shadows

Workers run the middle: dispatch and watch. They execute in the background while you decide.

FAQ

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 install.py --uninstall.
Does it replace me?
No. AI accelerates, it does not generate. You direct and review. The workers execute.

//