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:

2.0 KiB Raw Blame History