free · open source · macOS + linux
Your AI finally remembers you.
nixfredOS turns your AI coding assistant into a persistent co-worker with memory, laws, and a soul. It is the system behind Larry, an AI that has not forgotten a decision since January 2026.
why install
Your harness is the engine.
nixfredOS is the rest of the car.
Claude Code, Cursor and Codex are brilliant for an hour. Then the session ends and everything it learned about you is gone.
With nixfredOS
- ✓ It already knows. Your goals, stack, people and past decisions load before you type.
- ✓ Mistakes become rules. Error patterns and Laws are captured once and enforced forever.
- ✓ It proves before it claims. Verification gates and hooks stop "done" until it is actually done.
what you get
Everything Larry runs on.
None of Larry's secrets.
You get the whole engine with an empty memory. It fills up with your life, in your private repo.
Memory that compounds
SQLite FTS5 memory, auto-captured at session end and recalled on every prompt. Say "remember that" and it is written down, not promised.
Laws, not vibes
Rules that load every turn and survive context compaction. Ask before destroying. Check state before acting. Fail loudly.
56 skills
Research, red teaming, first principles, security, writing, art. Routed automatically when you just say what you want.
56 hooks
Guards that run before every tool call: secret scanning, public-push gates, drift reminders, verification gates.
The Algorithm
Every task moves from current state to a defined ideal state, with criteria you can actually check.
Pulse
A local dashboard showing what your AI is doing, what it learned, and how you rated it.
A private brain repo
Your whole AI config and memory committed to a private GitHub repo. Every decision is searchable with git log, forever.
It learns from you
Rate a response and the rating feeds back. The system gets measurably better at being yours.
install in one line
Two ways in. Both ask before touching anything.
① Let your AI install it
Paste this into Claude Code, Cursor, Codex or Gemini CLI. It reads the guide and walks you through every step, including your private GitHub brain repo.
you › Read https://github.com/nixfred/nixfredOS/blob/main/nixfredOS/INSTALL.md and install nixfredOS for me.② Or run it yourself
The terminal shortcut for macOS and Linux. It prints the sha256 of what it downloads before it extracts anything.
$ curl -fsSL https://raw.githubusercontent.com/nixfred/nixfredOS/main/nixfredOS/install/install.sh | bashNot sure you're ready? End it with | bash -s -- --check instead for a preflight report that installs nothing.
requirements
What you need. What it will never do.
Required
- macOS 13+ or a modern Linux
- git and curl
- bun 1.2 or newer
- gh CLI + a GitHub account
- An AI coding harness. Claude Code is the tested path
Optional extras
- Ollama for semantic recall (Apple Silicon or a GPU helps)
- An ElevenLabs key if you want your AI to speak
- Preflight:
--checkreports what's missing first
It will never
- ✗ Install Docker or run containers
- ✗ Send telemetry or analytics
- ✗ Store your memory in someone's cloud
- ✗ Push your brain to a public repo
nixfredOS is free, forever. If you'd like a hand setting it up or fitting it to your work, nixfred does 1:1 consulting. Friendly, hands-on, and it's paid time.