A file-based operating system

A business, run by something that writes down everything it does.

Okapi is not a dashboard, not a bot, and not a folder of clever prompts. It is an operating system for running a business day to day, built from plain files instead of a database only one vendor can read.

Why it's built this way

Software assumes the process is already known. Most businesses don't have one written down.

Most small operations run on memory: what the owner remembers, what the one long-tenured employee remembers, what got done last time so it probably gets done the same way this time. That works until someone is unreachable for a week and nothing moves. Okapi starts from the opposite assumption: write the process down first, then let something reliable execute it.

The old way

Knowledge lives in one person's head. A new hire, a locked-in SaaS tool, or a bad week takes the whole operation down with it.

Software gets bought to fix this, and instead adds a login, a training cost, and a vendor who owns the data.

The Okapi way

Every method, every decision, every correction is a file. Plain text and a handful of small databases, readable by any tool, owned by the business that built it.

Because it's just files, nothing about it depends on one AI vendor staying in business. Swap the model underneath and the system keeps running.

What's actually in it

Seven layers, each answering a different question

Click a layer to open it. These aren't invented categories for this page — they're the actual folder names the system runs on.

    What happens when it runs

    One request, travelling the whole system

    Nothing here is hypothetical — this is the literal path a request takes, from being asked to being remembered. Step through it.

    Why it improves instead of decaying

    The loop that closes

    Dowork happensLogthe recordMinethe patternRewritethe method

    Most systems rot quietly. A method gets written once, nobody revisits it, and six months later it's wrong in ways no one notices until something breaks.

    Okapi treats a mistake as data, not an embarrassment. Every session leaves behind a record of what was asked, what was delivered, and what had to be corrected. That record gets read back on a fixed cadence — patterns get mined out of it, and the method file that caused the mistake gets rewritten, not just the one output.

    The result is a system whose oldest parts are its most battle-tested, not its most neglected.

    What stops it doing something stupid

    Guardrails, not good intentions

    None of these are a policy written on a page and hoped for. Each one is a mechanical check, run before the risky step, not after.

    Before it runs

    Mechanical hooks

    Certain actions — publishing, spending, deleting, touching live infrastructure — are intercepted before they execute, not reviewed after the fact.

    Before it ships

    Human approval gates

    Anything that publishes externally or sends to a real person stages first and waits for a yes. The system drafts; a person decides what goes out.

    Reading untrusted input

    Quarantine by default

    Anything arriving from outside the system — an email, a scraped page, a flagged file — is read as data to summarise, never as an instruction to follow.

    Making a claim

    Confidence scoring

    Every diagnosis or recommendation can be asked to rate its own certainty. A wrong confident answer is treated as worse than an honest "I don't know."

    Before committing

    Argue the other side first

    Any significant recommendation has to survive its own strongest counter-argument, written out loud, before it's allowed to be the final answer.

    Citing anything

    Source provenance

    A date-sensitive claim or a quoted line has to trace back to a real, checkable source before it's allowed to be presented as fact.

    For comparison

    What it isn't

    Not this

    • A dashboard you have to check
    • A SaaS product with a login and a monthly bill
    • A chatbot that forgets everything between conversations
    • A folder of clever prompts held together by hope

    This instead

    • An operator that reads its own state before doing anything
    • An asset the business owns outright
    • A system with a permanent, growing memory
    • Encoded procedure, invoked by name, improved on a schedule

    Underneath it all: plain text files, a handful of small databases, and open integration standards rather than a proprietary format. Nothing about how it's stored requires any single company to keep existing.

    Want this in your business?

    This is what a Business Automation Assessment starts building — a system like this one, sized to what you actually run.

    Start with the free diagnostic →

    Okapi

    Built to run a business the way a careful operator would, if that operator never forgot anything and never stopped writing it down.

    What would you build if nothing you did this week had to be redone next month?