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

1. Create skills/<skill-name>/skill.md — what the skill does and how
2. Create skills/<skill-name>/learnings.md — starts empty, fills over time
3. Create skills/<skill-name>/eval.json — scoring criteria
4. Add a cron job on 172.27.40.3 calling the skill
5. 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:

• IP & Port Map
• Docker Stacks
• Network Overview