Operator OS: the whole business, on your machine, in files you own.

Nine CSV files, an engine that does the money math the same way every time, an event log that makes every change reversible, real double-entry books, a query language, a cash simulation with the odds attached, eight import adapters, a plugin SDK, an agent layer that runs the whole thing on a schedule, thirty-five tools, eight encoded businesses to start from, and a workbook covering every step on Mac and Windows. No account, no server, no subscription, nothing to log into -- Python 3.9 and an optional git install are the entire dependency list, on purpose.

Five minutes to something real

bash scripts/install.sh          # Mac and Linux
./os doctor                      # check this machine
./os migrate                     # set up the books and the rest of the schema
./os use 01-field-service        # load a real business
./os brief                       # see it running
./os sim                         # the same question, with the odds
./os books post                  # derive the journal from your registries
./os books check                 # three proofs that the numbers tie

Then make it yours: ./os use 01-field-service --empty, ./os setup, ./os brief. That last command printing your own business name is the finish line for day one.

What it does

Forty-three commands in total (os help lists them, os help <group> narrows it). The core ones:

Architecture

Four sources feed the same command line, and it is the only thing that ever touches the data — always through the event log first:

Everything above the event log is replaceable — write your own tool, adapter, or plugin, or fork a workspace. What never changes is that a mutation is logged before it is saved, which is what makes os undo, os rebuild, and os drift trustworthy no matter what put the row there.

The eight workspaces

Encoded starting businesses, picked by the failure mode they teach, not by trade:

Why files, not an account

Every registry opens in Excel. Git gives version history for free. Nothing proprietary means nothing to migrate away from later. The cost is no concurrency, which doesn't matter when the business is one person -- and if the project disappeared tomorrow, the business would keep running, because the business is the files, not the software.

What it will not do

• Never sends anything -- every draft (invoice, chase, follow-up, content) waits for you to send it.
• Never deletes a row -- dropped, lost, cancelled, written-off, and expired are statuses, not deletions.
• Never contacts anyone marked do_not_contact, without exception.
• Never leaves your machine -- no account, no server, no telemetry, no sync.
• Never gives tax, legal, employment, or insurance advice -- it hands you organized facts and tells you to take them to a professional.
• Never invents a number -- every figure traces to a row you can open.

How it's licensed

A permanent, per-business license, not a subscription -- install it on every machine you personally use, change any file including the engine, and keep using this version forever even if updates stop. It comes with a thirty-day no-questions refund, since every workbook module has a finish line you can check yourself: if module one doesn't end with your own business printing on your own screen, it didn't work.