Setup
Open-source AI Operating System (AIOS) blueprint for Claude Code & Codex — turn any agent into your personal second brain + Chief of Staff: skills, self-verifying workflows, a second-brain wiki, and deterministic tools. Fork it for any role or domain.
npx -y skills add alirezarezvani/gaios --skill setupAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
What its author says it does
Copied from the file, not written here
First-run guided setup for a fresh gAIOS clone. Interviews the user (identity, role, priorities, voice, connections, team, pain, guardrails) and fills the templates — CLAUDE.md, context/, references/voice.md, connections.md — then introduces the WAT / wiki / workflows / experiments features. Trigger on "/setup", "set me up", "get started", "onboard me", or a fresh clone where CLAUDE.md still has {{placeholders}}.
SKILL.md
3.1 KB, 692 tokens by cl100k_base, as published. Nobody here has run it
Setup — make this AIOS yours
A guided interview that turns the blueprint into a personalized AIOS. Read aios-intake.md first; if it's filled, confirm and scaffold; if not, run the interview conversationally, one question at a time, with a recommended answer so the user can confirm/correct.
Interview (capture each answer into aios-intake.md as you go)
- Who are you — role, company, what you own. (→
context/about-me.md,CLAUDE.mdheader) - Voice samples — ask the user to paste 1–2 real, unedited things they've written. Refuse typed-fresh prose (it contaminates the sample). (→
references/voice.md) - 90-day priorities — dated, concrete. Push back on vague. (→
context/priorities.md) - Business — what it sells, to whom, the model. (→
context/about-business.md, Knowledge base) - The stack — where revenue/customers/comms/docs/tasks live. (→
connections.md) - The team — roster + who can absorb delegated work. (→
context/about-team.md) - The constraint / pain — what eats the week; what to hand off first.
- Guardrails — the hard rules + sensitive-data line + any compliance regime (GDPR/HIPAA/SOC2/...); what may be sent/acted-on vs only drafted. (→
CLAUDE.mdGuardrails)
Scaffold (after the interview)
Fill every {{placeholder}} in CLAUDE.md (name, persona, knowledge base, voice summary, connections, guardrails — customize rule #1 and #8 to the domain). Write context/*, references/voice.md, and the connections.md rows. Back up any existing versions to archives/ first.
Introduce the engine (one screen)
Point the user at: /structure (frame fuzzy asks) · /triage · /daily · /weekly (Cadence) · /wiki (second brain: raw/ → wiki/) · /graph · /graph-query · /graph-ingest (knowledge graph) · /workflow (dynamic workflows) · /experiment (autoresearch loop) · /audit + /level-up (weekly). Then suggest the first prompt: "what should I focus on this week?"
Optional: knowledge graph (graphify)
Offer to set up the knowledge graph so the user can see and query their code + second brain: run python tools/graphify_setup.py install (installs graphify and wires the Claude Code & Codex skills). Then /graph builds it. Skippable and additive — graphs code + the committed wiki/ only, never raw/.
Rules
- Voice paste cannot be skipped or typed fresh.
- One-shot scaffold after the interview; the user iterates by editing
aios-intake.mdand re-running. - Customize the Guardrails block to the user's domain — don't ship the generic defaults unchanged for a regulated business.