aios

AI-OS

Your second brain for Claude Code. Persistent memory, learned patterns, skills that improve over time.

AI-OS is a Claude Code plugin that installs a brain-inspired operating system on your machine. It gives Claude a persistent place to remember, reason, and improve — across every session, in every repo, for as long as you keep using it.

Install once. Keep everything.

---

Why AI-OS exists

Claude Code is powerful inside a session and forgetful between them.

• Every new session starts from zero. No memory of what you decided yesterday, who you talked to last week, or what didn't work the last three times you tried it.
• No mechanism for learning. Claude makes the same mistake on Tuesday that it made on Monday, because nothing is captured.
• No place for your world. People, companies, projects, decisions — they live in your head or scattered across tools, not somewhere Claude can reach them.

AI-OS fixes this by giving Claude a file-system-native brain. A folder on your machine, modeled on the regions of a real brain, that Claude reads at the start of every session and writes to during it. Your knowledge stays local, versionable, and yours.

---

What you get

1. The brain (a folder on your machine)

One folder, modeled on the brain but named in plain language. Each folder has one purpose. Each file has a place.

Folder	What lives there
CLAUDE.md	Identity, decision rules, executive control
MEMORY.md	Long-term memory — user-triggered writes only
risks.md	Risk flags — read before important actions
memory/	Decisions, sessions, transcripts
learning/	Corrections, patterns, skill feedback
knowledge/	People, companies, market notes
projects/	Active projects, each with its own CLAUDE.md
routines/	Daily, weekly, and on-demand routines
blueprints/	Templates and reusable how-tos
voice/	Brand and communication style
system/	Goals, architecture, vital signs, setup progress
archive/	Inactive but searchable

No database, no cloud, no vendor lock-in. The folder is the brain — but you can read every file with a normal editor.

2. The skills pack

A curated set of skills that ship with the plugin and know how to use the brain.

• memory-search — search the brain before starting work
• decision-check — prevent contradictions by surfacing prior decisions
• nightly-consolidation — process short-term memory, extract patterns, improve skills
• morning-briefing — daily prioritized summary
• email-triage — categorize and draft replies
• meeting-prep — surface relationship and decision context
• relationship-check — last contact, open commitments, next action
• project-status — progress, blockers, next actions
• brain-dump-content — turn raw thoughts into structured content
• content-interview — Claude asks, you answer, drafts get made
• reflect — goal-by-goal progress and course correction
• foresight — forward-looking priorities
• signal-calibration — the brain tuning its own signal detector
• aios-start — one-shot install and setup
• aios-help — interactive guide: tour the system, check setup progress, ask anything

Skills improve over time. When you give feedback, the nightly consolidation edits the skill itself.

---

Install — three commands, two minutes

AI-OS is a Claude Code plugin distributed directly from this GitHub repo. No Anthropic marketplace submission, no gatekeeper, no shell script. Anyone with Claude Code installed can add it as a plugin marketplace in one line.

Prerequisites

Requirement	Check	Install
Claude Code	claude --version	docs.claude.com/en/docs/claude-code

That's it. No git, no bash, no node, no python3 required.

Step 1 — Add the marketplace

In any Claude Code session, run:

/plugin marketplace add ludwigawra/AIOS

This tells Claude Code to treat this GitHub repo as a plugin marketplace. Claude Code clones it locally (cached), reads .claude-plugin/marketplace.json, and registers AI-OS as an installable plugin.

Step 2 — Install AI-OS

/plugin install aios@aios

(Format: plugin-name@marketplace-name — both happen to be aios here.) Claude Code installs the plugin's skills, hooks, and commands into your Claude Code config. Nothing touches your system outside of Claude Code's plugin directory.

Step 3 — Bootstrap your brain

Open a Claude Code session in the folder where you want your brain to live (examples use ~/my-brain), then run:

/aios-start

This is a conversational onboarding skill — Claude walks you through a short setup (name, role, company, which integrations you use), then scaffolds your brain folder: nine regions, templates, an initial MEMORY.md, a CLAUDE.md personalized to you, a live system/setup-progress.md checklist, and session hooks wired up.