No description
  • Shell 60.7%
  • Python 39.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-16 03:34:24 +00:00
.cursor Add Cursor workspace meta, agent policy, and multi-root workspace file. 2026-11-08 15:56:30 -05:00
.secret .secret/READM.md added 2026-11-08 15:58:11 -05:00
.vscode Add interactive setup teardown and point Ogun at Wohpe docs. 2026-11-10 07:44:25 -05:00
docs Add ogun setup wohpe and switch install flags to opt-out defaults. 2026-11-15 22:29:42 -05:00
lib Add ogun setup wohpe and switch install flags to opt-out defaults. 2026-11-15 22:29:42 -05:00
srv Add ogun setup wohpe and switch install flags to opt-out defaults. 2026-11-15 22:29:42 -05:00
.claudeignore Add ignore rules so secrets and guest runtime stay out of git. 2026-11-08 15:56:03 -05:00
.cursorignore Add ignore rules so secrets and guest runtime stay out of git. 2026-11-08 15:56:03 -05:00
.gitignore Add ignore rules so secrets and guest runtime stay out of git. 2026-11-08 15:56:03 -05:00
AGENTS.md Add Cursor workspace meta, agent policy, and multi-root workspace file. 2026-11-08 15:56:30 -05:00
INSTALL-1st-PHASE.md Add ogun setup wohpe and switch install flags to opt-out defaults. 2026-11-15 22:29:42 -05:00
INSTALL-2nd-PHASE.md Add install phases and design docs for engines, CLI, and architecture. 2026-11-08 15:56:31 -05:00
mk-ogun Add host CLI, mk-ogun, and lib implementations for do_user and chat. 2026-11-08 15:56:30 -05:00
ogun Add ogun setup wohpe and switch install flags to opt-out defaults. 2026-11-15 22:29:42 -05:00
ogun_do_ctl.sh Add host CLI, mk-ogun, and lib implementations for do_user and chat. 2026-11-08 15:56:30 -05:00
ogun_do_ctl_postboot.sh Add host CLI, mk-ogun, and lib implementations for do_user and chat. 2026-11-08 15:56:30 -05:00
README.md Add ogun setup wohpe and switch install flags to opt-out defaults. 2026-11-15 22:29:42 -05:00

Ogun

Infrastructure agent for a TrueNAS SCALE host (kateryna). Ogun runs as a native LXC container (192.168.222.2) with Open WebUI as the chat UI, a shared identity file, and optional LLM engines that can operate the lab from on-box tools.

Sibling container: wohpe — privileged LXC for Docker / RunTipi app churn, kept off kateryna’s storage duties.

Goal

Ogun must be operable by whatever LLM engine is hooked up, with the same rules in /srv/ogun-identity.md. Prefer local tool execution on ogun over Cursor cloud VMs.

Engine priority: local models → Cursor → Claude → OpenRouter → generic APIs.

Layout (host)

ogun/                    # git root + Cursor workspace folder
├── .cursor/             # LLM rules + hooks
├── AGENTS.md            # Agent instructions (secrets policy)
├── .secret/             # Host/workspace credentials (gitignored)
├── .vscode/             # Multi-root workspace (ogun + wohpe)
├── ogun                 # Host CLI + curl|bash bootstrap
├── mk-ogun              # Recreate LXC + firstboot
├── lib/                 # Feature implementations (chat, do_user, …)
├── INSTALL-1st-PHASE.md # Bootstrap / first-install
├── INSTALL-2nd-PHASE.md # Engines, secrets, day-2 wiring
├── docs/                # Architecture, CLI, engine setup
├── legacy/              # Incus-era archives
└── srv/  ─────────────► /srv inside the container
    ├── .secret/         # Guest/engine credentials (gitignored)
    ├── openwebui/       # UI, pipes, identity filter
    └── ogun-identity.md # Canonical agent rules

Quick start

  1. Phase 1 — INSTALL-1st-PHASE.md
    Datasets, clone, container, provision, identity hooks, ogun_do.
  2. Phase 2 — INSTALL-2nd-PHASE.md
    Only the engines/secrets you actually want.
# On kateryna after the tree exists:
/mnt/szapps/lxc/ogun/ogun setup first-install
/mnt/szapps/lxc/ogun/ogun status --doctor

curl|bash (published raw URL):

curl -fsSL 'https://code.lksz.me/szmedia/ogun/raw/branch/main/ogun' \
  | SUDO=sudo bash -s -- setup first-install --root /mnt/szapps/lxc/ogun

Day-to-day

Command Purpose
ogun status [--doctor] Health / drift
ogun host start|stop|restart Container + Open WebUI
ogun chat … / ogun models Host → Open WebUI API
ogun setup agents … Install/list default agent pipes
ogun setup teardown Interactive reverse of first-install
ogun do_user test Host ogun_do SSH+sudo
ogun setup wohpe [args…] Fetch/run Wohpe first-install (WOHPE_REMOTE overrides repo)

Docs under docs/ — start with ARCHITECTURE.md, OGUN-CLI.md, and OGUN_DO_USER.md.

Remote

https://code.lksz.me/szmedia/ogun

Secrets: host .secret/ + guest srv/.secret/ (paths only in git). See docs/SECRETS.md.