ShayanSpiel

SpielOS — AI skill for Claude Code

AI community

An open-source AI company operating system: Goals, Runs, Workers, and AI departments under one Director loop (OBSERVE → DECIDE → ACT → EVALUATE).

How to install SpielOS

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ShayanSpiel/SpielOS and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What SpielOS does

An open-source AI company operating system: Goals, Runs, Workers, and AI departments under one Director loop (OBSERVE → DECIDE → ACT → EVALUATE). Run your company with AI agents.

Alternatives in AI

  • Multica — Make humans and AI agents work as one team — open-source and self-hostable 47.8k ★
  • Invisible Dots — Open-source, self-hosted alternative to OpenAI Dots, Meta Muse, Grok Bot, Manus Cue and Claude Cowork 31.8k ★
  • AIHawk — Open-source AI browser agent: describe any task in plain language and it autonomously browses, clicks, types a 30.3k ★

README

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