NxM Agent OS
A personal agentic operating system built on plain markdown files. Tool-agnostic — works with Claude Code, Ollama, or any LLM harness. Based on the framework from the AI Daily Brief episode "How to Build a Personal Agentic Operating System" (Nufar Gaspar, 2026-04-25).
How it works
Every agent interaction reads from and writes back to files in this repo. No databases, no APIs, no vendor lock-in. The files ARE the system.
The seven layers
| Layer | File(s) | Purpose |
|---|---|---|
| Identity | identity.md |
Who you are, communication style, values |
| Context | context/ |
Dated, task-specific working files |
| Brain | brain.md |
Persistent facts — infra, people, decisions |
| Memory | memory/ |
Short and long-term session notes |
| Skills | skills/ |
Repeatable workflows, each self-improving |
| Processes | skills/*/context/handoff.md |
Output passed between chained skills |
| Automation | cron on 172.27.40.3 | Scheduled skill execution |
Adding a new skill
- Create
skills/<skill-name>/skill.md— what the skill does and how - Create
skills/<skill-name>/learnings.md— starts empty, fills over time - Create
skills/<skill-name>/eval.json— scoring criteria - Add a cron job on 172.27.40.3 calling the skill
- The infra-monitor watchdog will automatically pick it up
Runtime
- Files live on server:
/opt/agent-os/(cloned from this repo) - LLM inference: Ollama at
http://172.27.6.139:11434 - Scheduled jobs: cron on
172.27.40.3 - Local editing:
/home/nxm/Documents/agent-os/on Kubuntu (this machine)
Infra reference
Cross-repo links to supporting documentation: