42 lines
2.0 KiB
Markdown
42 lines
2.0 KiB
Markdown
# 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](https://git.nxm.co.za/admin/nxm-infrastructure/src/branch/main/Quick%20Reference/IP%20%26%20Port%20Map.md)
|
|
- [Docker Stacks](https://git.nxm.co.za/admin/nxm-infrastructure/src/branch/main/Quick%20Reference/Docker%20Stacks.md)
|
|
- [Network Overview](https://git.nxm.co.za/admin/nxm-infrastructure/src/branch/main/Infrastructure/Network%20Overview.md)
|