admin/agent-os
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: comprehensive update — bring all Agent OS docs current for LLM onboarding

Browse Source 
All files were 5-7 weeks stale. Updated brain.md (complete service/agent/VPN/cron
inventory), identity.md (current expertise + infra context), CLAUDE.md (full agent
ecosystem table, Citadel tool registry, gotchas), README.md (LLM quick-start guide),
all memory files (current projects, decisions, constraints, persistent facts), and
infra-monitor skill.md (current container list with criticality tiers).

Also fixed: git remote switched from HTTP+embedded-token to SSH, removed references
to decommissioned services (Netbird, WireGuard, Flowise, Zabbix), corrected Ollama
IP (172.27.40.20), TrueNAS IP (172.27.40.220), and added 20+ services/agents that
were built since the last commit.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude Code
2026-06-19 17:15:11 +00:00
parent 638b2edd56
commit 6cebab9a4a
9 changed files with 427 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files
identity.md
+18 -11
View File
@@ -1,6 +1,6 @@
# Identity
> **Status: COMPLETE** — Interview completed 2026-05-01.
> **Status: COMPLETE** — Interview completed 2026-05-01, updated 2026-06-19.
This file defines who the user is, communication preferences, values, and rules all agents must follow. Every skill reads this file before executing.
@@ -11,7 +11,9 @@ This file defines who the user is, communication preferences, values, and rules
- **Name:** Jaco Bezuidenhout
- **Company:** Nexum SA (PTY) Ltd — Mossel Bay, South Africa
- **Role:** Business owner, IT admin, network engineer
- **Primary focus:** Network monitoring for early problem detection; IT infrastructure management for clients
- **Primary focus:** Network monitoring, NIST CSF compliance reporting, IT infrastructure management for clients
- **Domain expertise:** VLANs, inter-VLAN routing, firewall rules (OPNsense), split DNS, VPN (Headscale/OpenVPN S2S), Docker Compose, Ubuntu Server admin, reverse proxy (NPM), IPAM (NetBox), monitoring (Grafana/Uptime Kuma/InfluxDB)
- **Not expert in:** Kubernetes, cloud platforms (AWS/Azure/GCP), advanced Python (learning), application development
---
@@ -19,9 +21,10 @@ This file defines who the user is, communication preferences, values, and rules
Priority order:
1. **Monitoring & compliance** — collect firewall and software data to support NIST CSF report completion
2. **Coding** — scripting, automation, tooling
3. **Summarising** — distil logs, changelogs, reports into concise output
4. **General automation** — recurring tasks, scheduled jobs
2. **Client management** — TRMM remote management, Directus CRM, Frappe Helpdesk ticketing
3. **Coding** — scripting, automation, tooling
4. **Summarising** — distil logs, changelogs, reports into concise output
5. **General automation** — recurring tasks, scheduled jobs, backups
---
@@ -48,7 +51,7 @@ Priority order:
- Send any external message (email, webhook, notification)
- Push to git or any remote repository
- Drop, reset, or modify databases
- **Never use a cloud-hosted LLM** (OpenAI, Anthropic API, Google, etc.) unless explicitly instructed. All inference stays on local Ollama (172.27.6.139:11434).
- Expose any service publicly without confirming NPM + Cloudflare + firewall implications
---
@@ -56,13 +59,17 @@ Priority order:
- Depends on the task — choose the format that fits the output type.
- **Documentation always goes to Gitea** (or the agreed project location) so everything is tracked and searchable.
- **Long-term:** Chat channel integration (to be defined) will become a primary output channel alongside web/file output.
- **Notifications route through Raven** (Discord + Gmail) at `http://raven-notify:8400`
- **Agent web output** goes to `/opt/sites/<name>/` served at agents.nxm.co.za
---
## Infrastructure Context
- Local LLM: Ollama at `http://172.27.6.139:11434` (gemma4, qwen2.5-coder:7b)
- Server: Ubuntu at `172.27.40.3` — Docker host, all agent runtimes
- Git: Gitea at `https://git.nxm.co.za` — all code and docs live here
- Agent OS runtime: `/opt/agent-os/` on 172.27.40.3, mounted at `/mnt/agent-os` on Kubuntu
- **Ollama:** `http://172.27.40.20:11434` — Windows 11 Pro (NxM-AI), models: gemma4, llama3.1:8b, phi4
- **Server:** Ubuntu at `172.27.40.3` — Docker host, all agent runtimes
- **Hermes Native:** VM 108 at `172.27.40.30` — OpenRouter LLM, Honcho memory, WhatsApp connected
- **Git:** Gitea at `https://git.nxm.co.za` — all code and docs
- **Agent OS runtime:** `/opt/agent-os/` on 172.27.40.3
- **Credentials:** `~/.nxm-keys` (chmod 600) — API keys for NPM, OPNsense, Proxmox, TrueNAS, Plane, Gitea, NetBox
- **Claude Code:** installed on 172.27.40.3, primary AI assistant