SpielOS

SpielOS — AI Company Operating System (Open Source)

**SpielOS is an open-source AI company operating system**: a local harness for running your company with AI agents — durable goals, supervised runs, evidence, approvals, and **AI departments** that do real business work under one Director loop:

GOAL -> OBSERVE -> DECIDE -> ACT -> EVALUATE
          ^                            |
          +----------------------------+

The runtime owns every Goal, Run, approval, evidence record, and notification. Departments are **Lego packages**: self-contained folders that supply business behavior and never create another loop. Codex, OpenCode, Claude Code, and humans are all clients of the same persisted state. Nothing lives in chat memory — close the session, the company keeps its state on disk.

Install (one line)

pipx install spielos && spielos init

`spielos init` scaffolds a verified, self-contained harness home into your current folder — with OpenCode-style progress, an optional starter-department picker, host detection, and a runtime verification before it reports success.

Update (one line)

pipx upgrade spielos && spielos refresh

`pipx upgrade` fetches the newest release; `spielos refresh` re-vendors the runtime spine and host adapters into every home on this machine while keeping your strategy, assets, departments, installed agents, and `.spielos/` state.

No pipx yet? The bootstrap installer sets everything up (Python check, pipx, spielos) and runs init in an empty folder automatically:

curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/SpielOS/main/install.sh | sh

`spielos init` scaffolds a **fresh** home into your current folder — with OpenCode-style progress, an optional starter-department picker, host detection, and a runtime verification before it reports success.

Other install methods

`spielos` is also published to npm, Homebrew, and as a Docker image. Pick whichever fits your environment — all