How to build an AI operating system (AI OS)

Learn how to build an AI Operating System (AI OS) in Claude Code, Codex, or any AI agent, and use it to automate your business and life. You go from an empty folder to a system that knows you and runs every day.

Navid Moazzezby Navid MoazzezUpdated Sept. 11, 202646 min readBeginner to Advanced
~/my-ai-os
Runs inClaude CodeClaude CoworkChatGPTCodexCursorGemini CLIAntigravityGrok BotHermesOpenCodeOpenClaw
> /morning-brief
Contextabout-me.md
DataSupabase
ToolsGoogle WorkspaceSlackWhatsAppTelegram
MemoryMEMORY.md
Skills/morning-brief
AutomationsEvery weekday at 7am
AppsYour day on 1 page
Your day is ready

An AI operating system (AI OS) is the layer underneath your AI tools.

It holds your context, your voice, your offers, your customers and your workflows in one structured place that every AI agent you use can read.

Think of how macOS or Windows loads your files, your apps and your preferences the moment you log in. You don't tell it who you are every morning.

An AI OS does the same thing for your AI.

In this guide, you'll learn exactly what goes into an AI OS, and how to build yours from scratch:

  • What an AI OS is, and what it isn't
  • Why your business needs one
  • The 7 layers of an AI OS
  • How to build yours, step by step
  • How to measure it, and the mistakes to avoid

Let's start with what an AI OS actually is.

What is an AI operating system (AI OS)?

An AI OS is the layer underneath your AI tools. It holds your context, your voice, your offers, your customers and your workflows in one structured place that every AI you use can read.

In practice, it's a folder of plain text files: your AI OS workspace folder. It starts on your computer, and a copy in a private GitHub repo gives you a backup, team access and the option to run certain jobs in the cloud. You open that folder in an AI agent, and the agent reads your files at the start of every session, before you type a word.

Here's what that folder looks like:

~/my-ai-os
Claude Codev2.1.138
> /onboard
🧠CLAUDE.mdthe rules, read first every session
·AGENTS.mdsame file, so Codex and Cursor read the same rules
·GEMINI.mdsame file, so Gemini CLI reads them too
·MEMORY.mdwhat came up while working
context/who you are, your company, your voice, your brand, your tools
·about-me.md
·my-company.md
·voice-profile.md
·anti-ai-writing-style.md
·design.md
·tools.md
decisions/what was decided and why
·log.md
inbox/what's open, and your setup answers
·open-work.md
·onboard.md
daily-notes/One note per day
outputs/everything your AI OS makes, one folder per project
projects/briefs and references, one folder per project
references/the frameworks, SOPs and tool notes your AI OS runs on
assets/logos, headshots, fonts, colors
_archive/where deleted things go
·.mcp.jsonthe tools your AI OS can reach
.claude/
skills/the 12 skills
onboard/
morning-brief/
meeting-notes/
research-assistant/
slide-deck/
visual-explainer/
diagram-generator/
ai-os-daily/
ai-os-connect/
ai-os-audit/
ai-os-update/
ai-os-grow/
agents/
·brand-guardian.mdchecks every draft against your voice

That's how I run my own business: an AI OS with Claude Code as the brain.

And it isn't tied to one agent. Each agent reads a rules file when a session starts, and you point all of them at the same one:

AgentReads this rules file
CLAUDE.md
AGENTS.md
AGENTS.md and CLAUDE.md
GEMINI.md

So you set it up once. Then you can switch agents without starting over.

How an AI agent uses your AI OS

Every AI agent works in a loop. It looks at the situation, decides the next step, takes it, and checks the result. Then it goes around again until the job is done.

~/my-ai-os
lookreads your rules file, your context and the task
repeats until the job is done

Your AI OS is what the agent looks at, every time it goes around. The better that folder knows your business, the better every step.

What an AI OS is not

An app you download

It's a folder of plain files that the agent you already use reads

Something you need to code

It's written in plain English, and the agent handles the technical setup

Tied to one AI

Claude Code, Codex, Cursor and Gemini CLI read the same files

Just a starter kit

The AI OS Starter Kit is where you begin. The system is the layers you keep growing

AI OS vs ChatGPT, custom GPTs and automation tools

Here's how an AI OS compares to the tools you probably use today.

AI OSChatGPT or Claude chatCustom GPTsAutomation tools
Where it livesYour AI OS workspace folder, on your computer and in GitHubInside that one appInside one custom assistantInside each workflow you build
Works in other AI agentsYesNoNoNo
Works out the steps itselfYesYes, inside one chatYes, inside one chatMostly no, it runs the steps you mapped out

So keep the tools you like. An AI OS sits underneath them, and your agent can run them through connectors.

Navid Moazzez
@thenavidm

Most creators and founders are still stuck in chatbot mode. Build your own AI Operating System (AI OS) instead. The ones winning in 2026 and beyond run their entire business through it.

Why your business needs an AI OS

Without an AI OS, every tool starts from zero every time you open it.

So you paste in who you are. You explain your offer again. You fix the same wrong guesses. And tomorrow you do it all over again.

With an AI OS, the work compounds. Every correction you give, every tool you connect and every skill you add makes the next session better than the last.

Navid Moazzez
@thenavidm

You will not be replaced by AI. You will be replaced by someone who uses AI. And someone who uses AI will be replaced by someone with their own AI Operating System (AI OS).

Here's what an AI OS does for you, day to day:

It knows you

Every session starts already knowing your business, your customers, your voice and your tools

It writes like you

Your voice and your banned words are read before anything gets written, and a checker refuses the drafts that miss

It remembers

What you decide, what you correct and what comes up while working lands in files that load next time

It does the work

One skill hands you a finished result: a morning brief, meeting notes, research, a deck

It reaches your tools

Mail, calendar, notes and publishing tools are connected, so it reads real data instead of what you paste in

It works with any model

It's plain files, so Claude Code, Codex, Cursor and Gemini CLI read the same folder

And this is still early.

Navid Moazzez
@thenavidm

Learning Claude Code and building your own AI Operating System (AI OS) in 2026 is like buying Bitcoin in 2016 or 2017.

Don't miss out on this once-in-a-lifetime opportunity (again).

The 7 layers of an AI OS

Every AI OS is built from the same 7 layers. Each layer needs the one below it, so you build them in order.

LayerIts jobWhat goes in it
ContextKnows youYour rules file and your context files: who you are, what you sell, your voice
DataHolds your business in one placeCustomers, sales, content and conversations, linked so it can answer questions
ToolsReaches your appsConnectors to your email, calendar, CMS, payments and more
MemoryKeeps what it learnsYour brain, meetings, decisions, corrections and daily notes
SkillsDoes the workOne folder per job, each with a SKILL.md
AutomationsRuns without youDaily and weekly routines, and scheduled runs
AppsShows you the answerA brief page, a dashboard, a command center

The test for whether it's working is simple. Open a fresh session and type "write a post about my offer." If it names your offer and your price in your voice, your AI OS is working. If it asks what you sell, start with Context.

Here's each layer in depth.

Layer 1: Context

Context is everything your AI OS knows about you before you type a word: who you are, what you sell, who you sell to, how you write and the rules you work by.

An AI agent with no context gives you generic work, however good the model is. It doesn't know your offer, your customer or how you write, so it guesses. And every guess is something you have to fix.

Most people who give up on AI agents blame the model. In most cases, the agent simply didn't know enough about them.

Think about a new hire. On day 1, they're smart, but they know nothing about your business. You hand them your company docs, and within a week they do the work your way. Context is those docs, for your AI.

Context is a small set of plain text files written in markdown. Markdown is plain text with simple formatting, like headings and lists. It's the easiest format for an agent to read. A PDF or a Word file has to be unpacked first, which is slower and costs more.

It starts with your rules file. That's the one file your agent reads at the start of every session, so it holds 3 things: who you are in a few lines, how you want it to work, and a map of where everything else lives.

Then come your context files. The AI OS Starter Kit uses 6:

About me

Who you are, what you do and how you work

My company

What you sell, to whom, at what price, and what the next 90 days are about

Voice profile

How you write, built from things you actually wrote

Anti-AI style

The words, phrases and patterns you never use

Design

Your colors, fonts and visual rules

Tools

The tools you use, and which ones are connected

Not everything belongs in context. Some things your agent needs every single time. Other things it needs for one task only.

Always loadedLooked up when needed
What it isWhat every session needsWhat only one task needs
ExamplesWho you are, your offer, your voice, your rulesYesterday's support ticket, last month's sales, a client's history
Where it livesYour rules file and context filesYour data and your memory

Mix them up and your agent drowns. Load everything into every session, and the one fact that matters gets lost in the noise.

When your AI OS gets something wrong, the cause is almost always one of these 4:

A false fact

One wrong line gets repeated with confidence. Fix it by reading every line you save

Too much

The right fact gets buried. Fix it by keeping context lean and moving the rest into memory

A gap

The agent fills a missing fact with a guess. Fix it by saying where the answer lives

2 facts that disagree

An old price and a new one. Fix it by archiving the old version

A line earns its place when it changes what the AI writes, decides or refuses.

"I'm passionate about helping creators" changes nothing. "I never use the word journey, and every email ends with a question" changes every draft.

And read every line before you keep it. If your context says your customers struggle with something your product doesn't solve, that line ends up in every page, email and ad your AI writes.

Navid Moazzez
@thenavidm

I basically say a lot of things about me so they know this. I don't have to ever repeat this.

Layer 2: Data

Data is your business in one place your AI can query: your customers, your sales, your conversations, your content and your meetings.

Context tells your agent who you are. Data tells it what's actually happening in your business: who bought, what they asked, what sold and what worked.

Without data, you're back to copying numbers into a chat. And most business data is locked inside separate apps, where your agent can't see it.

Most businesses have the same 5 kinds of data. Here's what each one lets your AI OS answer:

DataWhere it might live todayA question your AI OS can answer
Sales and customersThriveCartStripePayPalWho bought in the last 30 days, and which offer did they buy?
Email listFlodeskWhich email brought in the most clicks this month?
Courses and communitySkoolWho joined this week?
ConversationsGoogle WorkspaceWhatsAppWhat did this customer ask us last time?
ContentWordPressXLinkedInYouTubeInstagramTikTokFacebookThreadsPinterestSubstackWhich pieces brought in the most sign-ups?
MeetingsGoogle MeetWhat did we agree on the last call?

The data layer does 2 things.

First, it brings your data into one place your agent can query, usually a database. Second, it links the records with one shared ID, such as a customer's email address.

That link is what matters most. It turns 5 separate exports into one answer. Ask about one customer, and your agent pulls their orders, their messages and their history together.

A database like Supabase works well for this. What matters is that it's one place, and your agent can read it without you.

Data is the facts of your business: records, numbers, orders. Memory is what your AI OS learns and wants to recall: decisions, corrections, notes and knowledge. Keep them apart, and each stays easy to search.

Never paste raw exports into your context files. Every line of context loads every session. Raw data belongs in your database, where your agent looks it up only when a task needs it.

Layer 3: Tools

Tools are the apps your AI OS can reach and use: your email, your calendar, YouTube, your CMS, your payments and more.

Context and data let your agent know things. Tools let it act.

With your tools connected, your agent can check your calendar, read your inbox, draft a reply, pull a report or prepare a post, without you copying anything in.

Here's a simple rule. Every time you paste something into a chat by hand, that's a tool that isn't connected yet.

Here are the kinds of tools most businesses connect:

What it's forWhat you might already useWhat your AI OS does with it
WebsiteWordPressCloudflareBuild, update and publish your pages
ServersHostingerHetznerRun your automations, agents and apps on a server that's always on
DatabaseKeep your customers, sales and content in one place your agent can query
Sales and paymentsThriveCartStripePayPalReport revenue by offer and look up any customer
Courses and communitySkoolDiscordSee who joined and what they're asking
Email listFlodeskDraft your next email in your voice
Email and calendarGoogle WorkspaceBuild your morning brief and draft replies
MessagesWhatsAppiMessageFind who's waiting on you and draft the reply
MeetingsGoogle MeetTurn every call into notes, decisions and next steps
Files and notesGoogle WorkspaceObsidianFind the document a task needs
PublishingXLinkedInYouTubeInstagramTikTokFacebookThreadsPinterestSubstackDraft the next post from what you've published
Research and competitor intelligenceRedditFacebook Ad LibrarySee what competitors publish, what's working and bring back the sources
Images and videoMake images and video from a brief
Video editingCut, caption and assemble videos from your script
Audio and musicMake voiceovers and music from a script

Every tool joins your AI OS through a connector. There are 3 kinds:

MCP server

A standard way for AI agents to use a tool. Claude Code, Codex, Cursor, Gemini CLI and Antigravity all support it

CLI

A command-line tool your agent runs directly in the terminal

API script

A small script that calls the tool's own API, for tools that have no connector yet

In Claude Code, a connected tool's details load only when a task needs them. So adding connectors doesn't weigh down every session.

Start with email and calendar. They power your morning brief, and they let your AI OS learn your voice from emails you actually sent.

Then connect where you publish, then payments, then the rest. Connect one tool at a time, each when a skill needs it.

Connect every tool read-only first. Turn on writing only when a specific skill needs it, and turn it on yourself.

Keep your keys in a local settings file that git ignores. Never in a chat, and never in a context file.

Where money is involved, give your AI its own account and its own key. You can see exactly what it did, and switch off that one key without touching anything else.

Navid Moazzez
@thenavidm

Something else people tend to miss is that ChatGPT got connectors. And Claude also got that. Perplexity and Gemini too.

Layer 4: Memory

Memory is what your AI OS keeps and can recall later. This is where your brain goes.

Every session with an AI agent ends. Without memory, everything you taught it ends with it.

Memory is what makes your AI OS better next month than it is today. Every correction, every decision and everything you learn stays, so you never teach it the same thing twice.

Here's how memory and context differ:

ContextMemory
SizeSmallBig, and it keeps growing
When it loadsEvery sessionOnly when a task needs it
Who writes itYou, onceYou and your AI OS, every day
ExamplesYour offer, your voice, your rulesYour brain, meetings, decisions, daily notes

There are 6 kinds of memory in an AI OS:

Your brain

What you read and learn, organized as a wiki your agent can search

Your meetings

Every call and transcript, ready to recall later

Your corrections

What you told it once, so it never makes that mistake again

Your decisions

What was decided, and why

Your daily notes

What happened each day, so every session starts where the last one stopped

Your published work

Everything you've made, ready to reuse and reference

Your agent may also keep a memory of its own. Claude Code, for example, saves notes per project by itself. Use it, but keep the memory that matters in files you can open and move.

A memory system does 4 jobs:

Capture

Save it the moment it happens: a correction, a decision, a transcript

Organize

Turn raw material into linked pages, with an index and a log

Recall

Find the right page when a task needs it, through the index

Maintain

Remove what's stale, merge duplicates and archive old versions

Your brain lives in its own folder, next to your AI OS, and your rules file points to it by path. Here's the shape:

my-brain/

my-brain/
├── raw/          the sources you drop in: transcripts, articles, notes
└── wiki/         the pages your agent writes and links
    ├── index.md  the map of every page
    └── log.md    what was added, and when

When a body of knowledge keeps growing on its own, like meeting transcripts, give it its own brain. Smaller brains are faster to search and harder to confuse.

Keep one small file of what's active this week, and have your agent read it first. It finds the current thing without searching everything.

Layer 5: Skills

Skills are the work your AI OS does.

A skill is an SOP for your AI. It's the same kind of document you'd hand a new assistant: how you do a job, step by step, what good looks like, and what to check before it's done.

You write it once. From then on, one command runs the job your way, every time.

For example, /morning-brief in the AI OS Starter Kit reads your calendar, the email that needs a reply and your open work. It picks the 3 things that matter today and writes it all on one page. You type one command, and you get the finished page.

Without skills, you explain the job every time you ask for it, and you get a different version every time.

With a skill, the job runs the same way every time. And every time you correct it, you fix the skill, so it gets sharper with every run.

Navid Moazzez
@thenavidm

I created a Tool Review Agent because it was a repetitive task I was doing a lot.

Every skill is a folder with a SKILL.md file. The file has 2 parts:

The top

A name and a description. The name is the command, and the description says when to use the skill

The body

The steps: what to read, what to do, what to write, and a check before it hands anything back

The folder can also hold anything else the skill needs, like reference notes, templates or a script.

Here's how /morning-brief is built:

PartWhat it says
Namemorning-brief
DescriptionUse it when the user wants the day laid out before it starts: "morning brief", "brief me", "what is on today"
Step 1Gather today's calendar, the email that needs a reply, open work and the news that matters
Step 2Pick the 3 things that matter today, each with one line of why
Step 3Write one page you can read in 60 seconds
Before returningEvery event and every email in the brief must exist in the source

Your agent doesn't read every skill in full. It starts with just the names and descriptions, and loads the full skill only when your request matches it.

~/my-ai-os
startreads the name and description of every skill
only the skill it needs is loaded

That's why the description matters so much. A vague description means your agent picks the wrong skill, or none at all.

Here's how a skill differs from the other parts of your AI OS:

What it isExample
SkillA procedure for one job, run with one command/morning-brief
Rules fileWhat applies to every sessionCLAUDE.md
Sub-agentA separate worker a skill can hand a task to, with its own contextbrand-guardian, which checks drafts against your voice
ToolAccess to an app, which a skill can useYour calendar

In Claude Code, custom commands and skills are now the same thing: every skill runs as a slash command. Skills live in .claude/skills/ in your project, or in ~/.claude/skills/ to use them in every project. The AI OS Starter Kit's skills follow the Agent Skills standard.

Here's what makes a good skill:

One job

A skill that does one thing well is easy for your agent to pick and easy for you to fix

A description that triggers

Name the words people actually say, like "brief me" or "what's on today"

Clear steps

Write them in the order you'd do the job by hand

What it reads and writes

Name the files, so nothing is left to guesswork

A check before it returns

For example, every event in the brief must exist in your calendar

Under 500 lines

Put long reference material in separate files in the skill's folder

Layer 6: Automations

Automations are what your AI OS runs without you starting it.

You only automate what already works by hand. A skill that fails at 7am with nobody watching is worse than one you run yourself at 9.

So automations sit on top of everything else: context that's been corrected, data that's connected and skills you've already run many times.

Automations run in 4 ways:

KindWhen it runsExample
On a scheduleAt a set timeYour morning brief, every weekday at 7am
On an eventWhen something happensA new lead lands in your CRM
At the start or end of a sessionWhen you open or close your agentShow your open work when you start, write your daily note when you stop
On demandWhen you askAny skill you run by hand

Start with one routine before you schedule anything.

Every day, run /morning-brief to start and /ai-os-daily to end. The daily note carries every correction into memory, so tomorrow starts where today stopped.

Every week, run /ai-os-audit to score your AI OS out of 100, then /ai-os-grow. It reads 2 weeks of your notes, finds what you did 3 or more times, and proposes one addition.

When the routine has held for a month, put it on a schedule.

Most business processes don't need an agent deciding things. A skill that runs the same steps at the same time every day is easier to trust, and easier to fix.

Layer 7: Apps

Apps show you the answer without you asking for it.

Every other layer answers when you ask. Apps show you what you need before you ask.

I run my own AI OS from a panel like this every day. Everything the other 6 layers produce shows up in one place.

An app can take 3 forms:

A daily brief page

Your day on one page, waiting when you sit down

A dashboard

Your numbers, your pipeline or your content, refreshed on its own

A command center

One panel for your entire AI OS

Start with the page you already have. /morning-brief writes your brief as one page you open in your browser.

Then build one page for each question you ask every day. Give each page one job, and have a scheduled skill refresh it, so the answer is current when you open it.

You don't have to leave the tools you already use. On HighLevel, for example, you can build a page with Claude and then use it inside HighLevel.

You can also have your AI OS build your own pages on top of the tools you use. On SamCart, for example, a sales dashboard with your own numbers.

How to build an AI operating system (AI OS)

Here's how to build your AI OS from scratch, one layer at a time. Each step builds one layer, in the same order as above.

Step 1: Install your AI OS and audit your week

Your AI OS is a folder. You install it once, then open it in the agent you already use.

On your computer, one command does it:

$ npx degit thenavidm/ai-os my-ai-os && bash my-ai-os/scripts/install.sh

That copies the folder without any git history, so it's yours from the first commit. The script checks that Claude Code is installed, makes the folder a git repo of your own, and opens Claude Code inside it.

Prefer not to use the terminal? Download the ZIP from GitHub and unpack it. Then open the folder the way you normally work:

Where you workHow to open your AI OS
Terminalcd my-ai-os, then claude for Claude Code or codex for Codex
VS CodeOpen the folder as your workspace, then open the Claude Code panel
Claude desktop appOpen the Code tab and add the folder as a project
ChatGPT desktop appPick Codex, then choose the folder it can read and edit
CursorOpen the folder

Every agent reads the same rules. AGENTS.md and GEMINI.md point to CLAUDE.md, so Codex, Cursor and Gemini CLI read exactly what Claude Code reads.

Agents that run in the cloud work differently. Claude Cowork, ChatGPT and Grok Bot can't open the folder the same way, so they connect to your AI OS through its hosted server instead: https://mcp.aios.guide/mcp. Each agent's own steps are in its drawer:

You need a Mac, Linux or Windows computer, and one of those agents. Claude Code needs a paid Claude plan, Pro or higher, and no API key. The 1-command install needs Node 18 or newer.

Once it's installed, write 2 lists.

The first list is every task you did 3 or more times this week. Those become your first skills and automations.

The second list is where your business actually lives: which app holds your email, your calendar, your customers, your sales, your content and your meetings. That list becomes your plan for data and tools.

AreaWhat you might useConnected?
Email and calendarGoogle WorkspaceNot yet
Sales and customersThriveCartStripeNot yet
Email listFlodeskNot yet
WebsiteWordPressNot yet
Courses and communitySkoolNot yet
MeetingsNot yet

Work through these in order, and tick each one off as you go:

Action steps0/5

Then check that your agent has read the folder:

Prompt 01 · Check it's installed

Read CLAUDE.md and tell me in 3 lines what this folder is and what you will do at the start of every session.

To write both lists faster, let your agent interview you:

Prompt 02 · Audit your week

Interview me one question at a time. First ask what I did 3 or more times this week that I'd hand to someone else. Then ask which tools I use every day, and where my customers, sales, content and meetings live. When you're done, give me both lists as 2 tables.

You're ready for Step 2 when these are true:

Before you move on0/3

Step 2: Build your context

Context is what your AI OS knows about you before you type a word.

It lives in 2 places. Your rules file, and 6 short context files.

Your rules file is CLAUDE.md in Claude Code, AGENTS.md in Codex and Cursor, and GEMINI.md in Gemini CLI. Make them the same file, so every agent reads the same rules.

Use your rules file as a map. It says where everything lives, so your agent goes straight to the right file instead of searching:

CLAUDE.md

## Where things live

- `context/`: who I am, my company, my voice, my brand and my tools. Read every file here at the start of every session.
- `MEMORY.md`: what came up while working. One line per fact.
- `decisions/log.md`: what was decided and why. Append only.
- `daily-notes/`: one note per day.
- `outputs/`: everything you make, one folder per project.

Then the 6 context files. Each one does one job:

FileWhat it holds
about-me.mdWho you are, what you run and how you work
my-company.mdWhat you sell, who it's for, your offers and your prices
voice-profile.mdHow you write, built from things you actually wrote
anti-ai-writing-style.mdThe phrases and patterns your AI must never use
design.mdYour colors, fonts and visual style
tools.mdThe tools you use, so it recommends and connects the right ones

The AI OS Starter Kit fills in all of them with one command, /onboard. It takes about 15 minutes.

It connects what it can reach, like your mail and your calendar. It reads your real writing before it asks you anything. Then it asks 12 questions, one at a time, and shows you every file before it saves it.

Answer out loud. Talking gets you more detail than typing, and it sounds more like you. A dictation tool like Wispr Flow or Voicenotes turns it into text.

Don't write a bio. "I'm passionate about helping creators" changes nothing. "I never use the word journey, and every email ends with a question" changes every draft.

Action steps0/6

When /onboard is done, check what it wrote:

Prompt 01 · Check your context

Read every file in context/ and tell me in 5 lines who I am, what I sell, who I sell to and how I write. Then list anything that is vague or missing.

Then test it on a real task:

Prompt 02 · Prove it works

Write a short post about my main offer, in my voice.

You're ready for Step 3 when these are true:

Before you move on0/3

Step 3: Bring your data into one place

Take your second list from Step 1. For each place your business data lives, export it or connect it.

Keep the tools you use. Connect each one in Step 4, or export its data into your AI OS folder.

Then make sure the records share an ID, like a customer's email address. That link is what lets your agent pull a customer's orders, messages and history together in one answer.

A database of your own, like Supabase, is a later step, for when you want your own HQ.

Prompt 01 · Bring in your data

Here are my exports. Link them by customer email, and show me the full history for one customer, so I can check the links work.

Start with the data you ask about most. For most businesses, that's customers and sales. Add the rest later.

Here's the order to do it in:

Action steps0/4

Then ask the question most business owners can never answer:

Prompt 02 · Prove it works

Who did I talk to in the past month and never follow up with?

You're ready for Step 4 when these are true:

Before you move on0/3

Step 4: Connect your tools

Start with email and calendar. Those 2 make your morning brief real.

Connect every tool read-only first. Turn on writing only when a specific skill needs it.

Keep your keys out of your files and out of the chat. In Claude Code, the key goes in .claude/settings.local.json, which git ignores, and your .mcp.json points to it by name:

.mcp.json

{
  "mcpServers": {
    "your-tool": {
      "command": "npx",
      "args": ["-y", "your-tool-mcp"],
      "env": { "YOUR_TOOL_API_KEY": "${YOUR_TOOL_API_KEY}" }
    }
  }
}

Each agent keeps its connector settings in its own place:

AgentWhere connectors are set up
claude mcp add, or .mcp.json in your project
~/.codex/config.toml
~/.gemini/config/mcp_config.json

The AI OS Starter Kit has a command for this, /ai-os-connect. It connects one tool at a time, tells you where the key goes, and runs one read to prove it works.

Where money is involved, give your AI its own account and its own key. You can see exactly what it did, and switch off that one key without touching anything else.

Here's the order to do it in:

Action steps0/5

To connect a tool, paste this into your agent:

Prompt 01 · Connect a tool

Connect my [tool] read-only. Tell me where the key goes, keep it out of the repo, then run one read to prove it works.

Once your email and calendar are connected, test them:

Prompt 02 · Prove it works

What's on my calendar tomorrow, and which emails need a reply?

You're ready for Step 5 when these are true:

Before you move on0/3

Step 5: Set up your memory system

Memory has a few parts. Set up each one, and your AI OS stops forgetting.

Your corrections go in MEMORY.md, which loads every session:

MEMORY.md

## Corrections

## Preferences

## Infrastructure

Every time you correct your agent, save the correction with the reason. The reason lets it apply the rule to cases you never mentioned. After a correction has held for a month, move it into your rules file.

Your decisions go in decisions/log.md: the date, the decision and why. Your days go in daily-notes/, one note per day.

Your brain goes in its own folder, next to your AI OS, never inside it. Drop a source into raw/, and your agent turns it into pages in wiki/, with an index and a log. Your rules file points to the brain by path.

Claude Code also keeps a memory of its own, per project. Use it, but keep the memory that matters in files you can open.

Prompt 01 · Turn a source into your brain

Read the new file in raw/. Turn it into wiki pages in wiki/, link it to the pages it relates to, add it to wiki/index.md, and log what you did in wiki/log.md.

Keep one source of truth. When 2 notes disagree, like an old price and a new one, archive the old one, or your agent won't know which to trust.

Here's how to set it up:

Action steps0/6

A week later, check that it remembers:

Prompt 02 · Prove it works

What did I correct you on last week, and what have you done differently since?

You're ready for Step 6 when these are true:

Before you move on0/3

Step 6: Add your skills

Start with the skills that come with the AI OS Starter Kit:

SkillWhat it does
/morning-briefYour calendar, the mail that needs a reply, open work and the 3 things that matter today, on one page
/meeting-notesTurns a transcript into notes with decisions and a who-what-when table
/research-assistantResearches a topic into a sourced brief you can send
/slide-deckBuilds a 5 to 15 slide presentation in one HTML file
/ai-os-dailyEnds the session: writes today's note, updates open work and saves your corrections
/ai-os-growReads 2 weeks of notes and proposes the one thing your AI OS should add next

Then build your own. The rule: build a skill the third time you do the same task by hand.

A skill is a folder with a SKILL.md file. The top of the file tells your agent what the skill is for and when to use it:

.claude/skills/weekly-report/SKILL.md

---
name: weekly-report
description: When the user wants the weekly report. Reads this week's daily notes and sales, and writes one page with what happened and what's next.
---

# Weekly report

1. Read this week's daily notes.
2. Pull this week's sales.
3. Write one page: what landed, the numbers, what's next.
4. Check every number against the source before returning.

Keep each SKILL.md under 500 lines, and give each skill one job.

Prompt 01 · Turn a task into a skill

I do this task every week. Here's how I do it: [your steps]. Turn it into a skill with a clear description of when to use it. Then run it once with me, and fix what it gets wrong.

Skills work the same way in Claude Code and Codex. Both follow the open Agent Skills standard: a folder with a SKILL.md file.

Claude Code reads skills from .claude/skills/ and runs them with /skill-name. Codex reads them from .agents/skills/ and runs them with $skill-name.

To install a skill someone else wrote, copy its folder into .claude/skills/ in Claude Code. In Codex, use $skill-installer.

In Claude.ai and the Claude desktop chat, you upload a skill as a zip. Turn on Code execution and file creation in Settings, Capabilities. Then go to Customize, Skills, click the plus button, and choose Upload a skill.

A plugin is several capabilities in one install. It can bundle skills, sub-agents and hooks, and it can bring its own tools too.

In Claude Code, add a plugin marketplace, then install from it. The AI OS Starter Kit is 1:

Claude Code

/plugin marketplace add thenavidm/ai-os
/plugin install ai-os@ai-os

Anthropic's own catalog, claude-plugins-official, is already there. Browse it with /plugin, or at claude.com/plugins.

In Codex, open the Plugins tab, or type /plugins in the CLI, and select the plus button to install.

Only install plugins you trust. A plugin can run code on your computer.

Other agents handle skills and plugins their own way. Check each agent's own docs before you copy a folder in.

Here's how to build your first skill:

Action steps0/5

Then put your new skill to work:

Prompt 02 · Prove it works

Run my new skill on this week's work. Then tell me what you would change in it.

You're ready for Step 7 when these are true:

Before you move on0/3

Step 7: Automate what already works

Only automate a skill after it has worked by hand for a few weeks.

Start with a daily and a weekly routine. Every day, run /morning-brief to start and /ai-os-daily to end. Every week, run /ai-os-audit to score your AI OS out of 100, then /ai-os-grow to add one thing.

Then put what works on a schedule. In Claude Code, you have 3 ways:

OptionWhere it runsShortest intervalGood for
/schedule (routines)In the cloud, with no access to local filesOne hourRuns that must happen while your laptop is closed
Desktop scheduled tasksOn your computer, with your local filesOne minuteDaily routines that need your files
/loopInside your open session, for up to 7 daysOne minuteChecking on something while you work

A cloud routine starts from a fresh copy of your repo, so it can't read files that only exist on your laptop. Put what it needs in the repo, or run it as a desktop task.

Here's how to get there:

Action steps0/4

When a skill is ready, put it on a schedule:

Prompt 01 · Schedule it

Schedule /morning-brief to run every weekday at 7am as a desktop task, so it can read my files. Then show me where to check that it ran.

After a week, check what ran without you:

Prompt 02 · Prove it works

What ran on its own this week, and what did it produce?

You're ready for Step 8 when these are true:

Before you move on0/3

Step 8: Add your apps

The first app is already there. /morning-brief writes your brief as one page you open in your browser.

From there, build one page for each question you ask every day: your numbers, your pipeline, your content. Each page refreshes on its own, so the answer is waiting before you ask.

Prompt 01 · Build your first page

Build me one page that shows this week's sales, my open work and my next 3 calendar events. Refresh it every morning at 7, and tell me how to open it on my phone.

Then make that page part of your day:

Action steps0/4

The next morning, check it:

Prompt 02 · Prove it works

Open my page and tell me what changed since yesterday.

Your AI OS is built when these are true:

Before you move on0/3

Your AI OS action plan

Here's your AI OS action plan: every step of building your AI operating system (AI OS) in one list, so you can tick it off as you go. It follows the 8 steps above.

1. Install and audit

Action steps0/3

2. Context

Action steps0/3

3. Data

Action steps0/3

4. Tools

Action steps0/3

5. Memory

Action steps0/3

6. Skills

Action steps0/3

7. Automations

Action steps0/2

8. Apps

Action steps0/2

Your first 14 days

Here's what to expect in your first 2 weeks, and the month after.

WhenWhat happens
Day 1/onboard takes about 15 minutes. After it, a fresh session knows who you are, what you sell and how you write
Week 1A morning brief to start each day and a daily note to end it. On day 7, your first audit score out of 100
Week 2/ai-os-grow reads 2 weeks of notes and adds your first skill of your own
Month 1Corrections stop repeating. Every correction that held for 30 days can become a rule

Most first audit scores are low, and that's fine. The number climbing is the point.

AI OS KPIs: how to measure your AI OS

These are your AI OS KPIs: one number for each layer that tells you whether it's working.

You can't improve what you don't measure. Here's one thing to track for each layer:

LayerYour AI OS KPIWhere you want it
ContextTimes you had to re-explain something it should know0
DataQuestions it answers from your data without you pasting anythingUp every month
ToolsTimes you pasted something in by hand0 for connected tools
MemoryCorrections you had to give twice0
SkillsRepeat tasks that now run from one skillUp every month
AutomationsWork done while you were awayUp every week
AppsAnswers you got by opening a page instead of askingUp every month

On top of that, /ai-os-audit scores your whole AI OS out of 100 every week, and puts it in one of 4 stages:

ScoreStageWhat it means
0 to 39FolderIt's still a folder with files in it
40 to 69Set upThe context is filled, but the daily note isn't written every day yet
70 to 89RunningSessions start where the last one stopped, and it sounds like you
90 to 100CompoundingIt reaches your tools, it learned from you this month, and it added something to itself
Navid Moazzez
@thenavidm

Your first setup won't be perfect. Mine is not perfect, but I have probably better than 99% of people. Update your guides every time you catch something is off.

Common AI OS mistakes

These are the mistakes that hold most AI OS setups back, and the fix for each 1.

Writing a bio instead of a brief

"I'm passionate about helping creators" changes nothing your AI writes. Neither does your life story.

What changes the output is facts it can act on: your offers and your prices, who buys them, the words you never use, how every email ends.

The fix: go through each context file and delete any line a competitor could paste onto their own site. Replace it with a name, a number or a rule.

Putting everything into context

Context loads in every session. So every line you put there is read every time, whether the task needs it or not.

Put too much in, and the right piece gets lost in the noise.

The fix: keep context to what every session needs: who you are, what you sell, your voice and your rules. Everything else goes into memory, where your agent looks it up only when a task needs it.

Pasting the same data in every day

Every time you paste in the same numbers, notes or customer details, you're doing the job a connection should do.

The paste is also where mistakes creep in. You grab last week's file, or half of a list.

The fix: treat every repeat paste as a missing connection. Connect that tool in Step 4, read-only first.

Giving your AI your personal account

With your own login, your AI can do anything you can do. And when something goes wrong, you can't tell what it did from what you did.

The fix: give it its own account and its own key, read-only first. You see exactly what it did, and you can switch off that one key without touching anything else.

Automating before it works by hand

A schedule runs a skill whether its output is right or not. Automate a skill that's still wrong, and you get the wrong result every morning, on time.

The fix: run it by hand for a few weeks. When you stop fixing its output, put it on a schedule in Step 7.

Treating it as finished after setup

Setup is day 1. Memory pays off after weeks, as your corrections pile up and your agent stops repeating the same mistakes.

The fix: run /ai-os-daily at the end of every day. Once a week, run /ai-os-audit to see your score, then /ai-os-grow to add one thing.

Your AI OS summary

That's the full system, one layer at a time.

If you followed the steps, here's what you built:

  • Your workspace: one folder, installed and open in your agent
  • Your context: 6 files that tell every session who you are and how you write
  • Your data: the records you ask about, connected or in one place
  • Your tools: your email, your calendar and the apps you live in, connected read-only
  • Your memory: corrections, decisions and daily notes that don't get lost
  • Your skills: the starter kit's skills, plus one of your own
  • Your automations: your morning brief, waiting before you sit down
  • Your apps: one page that answers before you ask

Each layer only works because the one under it exists.

What matters most

Context comes first. Every layer after it works better because your AI already knows you.

Keep the tools you use. You don't switch anything to build an AI OS. You connect what you already have.

Build it by hand, then automate it. A skill earns its schedule by working first.

Final thoughts

Your first setup won't be perfect. Mine isn't either.

Update your files every time you catch something that's off. The more you run it, the more it knows, and that's the part that compounds.

Where to go next

Each layer has its own page, with more depth than this guide:

  • Context: what goes into your context, and how to keep it lean
  • Data: how to bring your business data into one place
  • Tools: how to connect your apps safely
  • Memory: how to build a memory system that never forgets
  • Skills: the skills that come with your AI OS, and how to build your own
  • Automations: how to run your AI OS without you
  • Apps: how to see the answer without asking
  • MCP & CLI: how to connect your AI OS to any AI agent

Start with the layer where you lose the most time.

FAQs about building an AI OS

Here are answers to the questions people ask most while building their AI operating system (AI OS).

An AI OS is the layer underneath your AI tools. It holds your context, your voice, your offers, your customers and your workflows in one structured place that every AI you use can read.

The first version takes about 15 minutes with /onboard in the AI OS Starter Kit. After that, your AI OS grows one addition at a time, usually one a week.

No. An AI OS is written in plain English, and your agent handles the technical setup.

Any agent that reads a folder. The AI OS Starter Kit is built for Claude Code, and the same folder works with Codex, Cursor and Gemini CLI.

Context is small and loads every session: who you are, what you sell, how you write. Memory is big and gets looked up only when a task needs it: your brain, meetings, decisions and daily notes.

In one place your agent can query, such as a database, with tables linked by a shared ID like a customer's email address.

Not on day 1. Your context and skills work without any. Add a connector, an MCP server or a CLI, when a skill needs to reach a specific tool.

In a local settings file that git ignores, such as .claude/settings.local.json in Claude Code. Never in a chat, and never in a context file.

Save it to a file your agent reads every session, such as MEMORY.md. A correction that only lives in the chat is gone when the session ends.

Give it 5 to 10 things you actually wrote, plus a list of words and phrases you never use. Then have a checker read every draft against both before you see it.

Yes. In Claude Code, /schedule runs routines in the cloud, at most once an hour, and desktop scheduled tasks run on your own computer. Automate a skill only after it works by hand.

The AI OS Starter Kit is free. You pay for your AI agent's plan, and for any paid tools you connect.

Was this page helpful?