AIOS — Your AI Operating System

The starter kit that turns Claude Code into your business's AI operating system. Built by CompanyZero.

Drop-in skills, references, hooks, and accumulated knowledge — same conventions, same patterns, same anti-patterns banned. One paste-prompt away from a working setup. Built for owners who run more than one business or multiple departments under one business.

How to install

Read INSTALL.md. The whole flow is:

1. Make sure you're on Claude Max 5x (Pro/free can't handle a full build session)
2. Install Claude Code from claude.ai/download
3. Paste the bypass-permissions prompt from INSTALL.md (one-time setup)
4. Paste the install prompt from INSTALL.md — Claude downloads the bundle, files things into ~/.claude/, creates your workspace + first business folder, and runs /aios-onboard
5. Answer the ~19 onboarding questions for your first business (~30-45 min)

Done. You're ready for Build Session 1 with Matthew.

Workspace structure (one workspace, many businesses)

Your AIOS is set up as a workspace that holds one or more businesses. Each business has its own context — its own offer, voice, customers, GTM, goals. Skills live globally at ~/.claude/ so they work in every business.

~/Desktop/AIOS/                  ← Workspace (you pick this location during install)
├── README.md                    ← Workspace-level docs (this file)
├── INSTALL.md                   ← Install reference
│
├── zhm/                         ← Business 1 (named during install)
│   ├── CLAUDE.md                ← System handbook for THIS business
│   ├── context/                 ← Business profile, voice, ICP, GTM, goals
│   └── templates/
│
├── consulting/                  ← Business 2 (add later via "add new business" prompt)
│   ├── CLAUDE.md
│   ├── context/
│   └── templates/
│
└── side-project-x/              ← Add as many as you need
    └── ...

To work on a specific business: open Claude Code in that business's folder. Skills automatically read the right context.

To add a new business: paste the "add new business" prompt from INSTALL.md — Claude creates the folder, scaffolds context, and runs /aios-onboard for the new business.

For departments inside a single business: create department subfolders inside the business folder. Each can have its own context/ if it needs separate voice/ICP/goals, or share the parent's.

What ends up where on your machine

After the install prompt runs:

AIOS bundle path	Where it lives on your machine	Why
.claude/skills/*	~/.claude/skills/	Skills available in every Claude Code project
.claude/references/*	~/.claude/references/	Same — global reference docs
.claude/hooks/*	~/.claude/hooks/	Safety hooks active everywhere
.claude/rules/*	~/.claude/rules/	Guardrails active everywhere
README.md, INSTALL.md	Workspace root (e.g. ~/Desktop/AIOS/)	Workspace-level reference
CLAUDE.md, context/, templates/	First business folder (e.g. ~/Desktop/AIOS/zhm/)	Per-business — /aios-onboard writes context files here

How skills work

A skill is a markdown file at .claude/skills/{name}/SKILL.md. Type /{name} in chat and Claude runs it. Skills read context from whichever business folder Claude is invoked in — so the same skills produce different output for each business based on that business's voice, ICP, and goals.

Updating

When new skills or fixes land in this repo, paste the update prompt from INSTALL.md into Claude Code to refresh just the ~/.claude/ files. Your businesses' context stays untouched.

Support

Your ZHM sprint includes weekly coaching plus unlimited WhatsApp/email support. Stuck? Message Matthew.