Open source · local-first · no account
DotAIOS is one folder on your computer — ~/aios/ — holding your context,
your memory, and the things you want your AI to do. Claude Code, Cursor, Gemini, Codex, and anything
that reads AGENTS.md all read from the same place. Write it once; every tool knows.
Works with the agents you already use
Features
Your context is the start. DotAIOS also pulls in what you read, remembers what you discussed, and follows you across devices — all as plain files you own.
Write who you are, what you're working on, and how you like to work. Every tool on your machine reads the same context — no re-explaining yourself in each new chat.
A compact working-memory digest — today's focus, carry-overs, recent sessions — is injected at the start of each session, so a fresh agent picks up where the last one left off.
Hand it a URL, a PDF, or a document and DotAIOS pulls clean Markdown into your vault — JavaScript-heavy pages included, via a built-in headless browser.
Your AI relearns who you are every single session.
DotAIOS gives it one folder to read instead — local, plain text, and yours. .gitconfig makes Git know your name; ~/aios/ makes every AI know your life.
How it works · no command line required
Paste one line into the agent you already use. It installs DotAIOS, creates the folder, and asks who you are.
One short rule per tool, written for you. Claude Code, Cursor, Gemini and Codex all start reading the same folder.
Skills become things you just say: "plan my day", "save this article", "close out today" — the same in every tool.
Trust
DotAIOS is the opposite of a black box. There's no server we run, no account to create, and nothing you can't read with a text editor.
Everything lives in ~/aios/ as plain Markdown and JSON you can open, edit, grep, and back up yourself.
Nothing to sign up for. We host no database and see none of your data. The CLI runs entirely on your computer.
Want it on your phone too? Opt into sync to a private GitHub repo you own. The token never leaves your machine.
Every line is on GitHub. Audit it, fork it, extend it with plugins and skills. No lock-in, ever.
Get started · about a minute
It does the whole install for you — you never touch a terminal. Then answer three quick questions and you're set.
Set up DotAIOS for me: read github.com/filocosta46/dotaios and follow INSTALL.md step by step.
npx dotaios setup
FAQ
No. The recommended way to install is to let an AI agent do it: you paste one sentence and answer a few questions in plain English. You never open a terminal or write code.
On your computer, in a folder called ~/aios/, as plain Markdown and JSON. There's no server we run and no cloud database. You can read and edit every file yourself.
Anything that reads an AGENTS.md file — Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, and more. Using a browser chat like Claude.ai or ChatGPT? Paste your AGENTS.md at the start and it has your context immediately.
Yes, optionally. Turn on sync and DotAIOS mirrors your folder to a private GitHub repo you own, so an AI on another machine — or your phone — reads the same memory. It's opt-in and runs on your GitHub, not ours.
Yes. DotAIOS is MIT-licensed and free. The whole project is on GitHub.
Local · open source · no account · your folder, your rules.