gAIOS — your personal AI Operating System

Clone it, run /setup, and it becomes yours in Claude Code or Codex — a second brain + Chief of Staff that holds your context, structures your work, drafts in your voice, and runs reliable workflows.

Open-source and opinionated — complete out of the box, not a blank slate. Fork it and make it yours for any role, company, or domain.

---

Quick start

1. Clone this folder to your machine.
2. Open it in Claude Code or Codex and run /setup (in Codex: invoke the setup skill or just ask it to "run setup").
3. Answer the guided interview (identity, voice, priorities, stack, team, guardrails). It fills CLAUDE.md, context/, references/voice.md, and connections.md.
4. Try the first prompt: "what should I focus on this week?"

Not sure what to write? Skim examples/ first — directional guides by role (founder, ops, regulated medtech, creator, sales) that show the shape of a filled gAIOS. They're direction, not data — you won't copy them.

Runtime compatibility (Claude Code · Codex · others) is summarized in Compatibility below.

---

What's inside (the architecture)

The Four Cs — Context (knows your business) · Connections (reaches your stuff) · Capabilities (knows how to do the work) · Cadence (runs without being asked).

The Three Ms — Mindset · Method · Machine (references/3ms-framework.md). Both frameworks inspired by Nate Herk's work — see NOTICE.

WAT — Workflows · Agents · Tools. Probabilistic AI reasons; deterministic code executes. Boring, testable, auditable.

Features (all included):

• /structure — turn any fuzzy input into a clear brief.
• /triage · /daily · /weekly — the Cadence layer: batch-sort an inbox, get a focused daily brief, run a weekly operating review.
• /wiki — a second brain: drop notes in raw/, get clean cross-linked knowledge in wiki/ (with a leakage-scanning lint gate).
• /graph · /graph-query · /graph-ingest — a knowledge graph (graphify) over your code + wiki/: build/visualize it, query relationships, and ingest external sources into the second brain.
• /draft · /prep · /decide — Chief-of-Staff core: draft comms in your voice, prep a one-page brief for any meeting/person, and frame + log a decision.
• /workflow — dynamic workflows: goal-driven, composable, self-verifying pipelines with a quality gate per step.
• /experiment — an autoresearch loop (try → measure → keep/revert → log), with a runnable forecast example.
• /exec-cockpit — a leadership-transition / exec-cockpit template.
• tools/ — deterministic Python (branded-HTML renderer, wiki lint, experiment log).
• Operating discipline baked into CLAUDE.md (think-before-acting, simplicity, surgical changes, goal-driven, verify-before-done).
• A brand kit template (brand-assets/) so outputs render on-brand.

---