🧭 Workspace Wiki Command Center

Operator command center for the /home/mc workspace: public routes, project docs, OMP, Hermes, AIRI, Nexus, and Moincraft runtime operations.

Canonical operator knowledge base for /home/mc: projects, services, OMP/Pi tooling, Hermes profiles and skills, Moincraft runtime, cheat sheets, status summaries, and forward plans.

⚡ 30-Second Operator Start#

cd /home/mc/wiki
npm run wiki          # local preview at 127.0.0.1:${WORKSPACE_WIKI_HUGO_PORT:-1314}
npm run wiki:build    # generate curated content + Hugo output in public/wiki
npm run wiki:deploy   # publish verified public/wiki to wiki.moincraft.de

If source data changed: run npm run wiki:content before previewing so Hermes and service summaries are regenerated. Moincraft runtime commands still run from /home/mc/moincraft.

🗺️ Workspace Map#

• ⛏️ Moincraft — Mineflayer bots, Paper server, relay, Svelte dashboard, Prismarine viewer, PM2/runtime ops.
• 🧸 AIRI — pnpm/Turbo TypeScript/Vue monorepo for AI companion surfaces, shared packages, and LLM proxy.
• 📊 Nexus Dashboard — Python collectors, static dashboard, WebSocket updates, research/news/KB engines.
• 📚 LLM Wiki Site — Hugo self-discovering knowledge base with scan/lint/full pipeline.
• ⬡ Manifest — generated static service map for ports, routes, cron, and architecture facts.
• 🪽 Hermit/Hermes — runtime config, profiles, skills, memory/kanban collectors; hidden state stays private.
• 🧰 Local bin — local wrappers and binaries, notably Hugo and Sass wrappers used by this wiki.

🚦 Service Cheat Sheet#

🤖 OMP + Hermes Mental Model#

• OMP (π) = interactive coding/runtime harness at ~/.local/bin/omp, with sessions under ~/.omp/agent and plugin state under ~/.omp/plugins.
• Pi compatibility = many plugins still read PI_* variables; keep compatibility in /home/mc/.env and /home/mc/.local/bin/omp-plugin-env.
• Hermes = profiles, skills, memory/kanban/data workflows feeding Nexus summaries and this wiki’s generated pages.
• Discord remote = trusted-user remote control. Treat allowlisted users like shell users; keep tokens and launcher secrets out of public docs.

⛏️ Moincraft Bot Ops#

cd /home/mc/moincraft
npm run check        # relay syntax + dashboard Svelte check
npm run build        # dashboard build
npm run verify       # stack verification script
npm run contract     # relay contract check
npm run green        # check + build + verify + contract

Live-service commands are intentional operations: ./launch_all.sh, ./stop_all.sh, npm run pm2:start, PM2 restarts, and server operations can mutate runtime state.

🔒 Safety Rules#

• Never publish .env, API keys, tokens, passwords, RCON credentials, auth state, sessions, raw DBs, WAL/SHM files, caches, or unfiltered logs.
• Generated output lives in /home/mc/wiki/public/wiki; edit source content and scripts/build-wiki-content.mjs, not generated HTML.
• Generated Hermes pages summarize structured safe JSON only; they do not dump persona text, private memories, or raw diagnostics.
• Public pages may document variable names and safety rules, but never secret values.

🧯 Fast Fix Matrix#

📚 Deep Links#

• 🚀 Quick Start
• 🗺️ Projects
• 🛠️ Operations
• 🌐 Public Routes
• 🤖 OMP / Pi
• 🚀 OMP + Kanban + Crons Swarm
• 🧭 Cronsban Full Blueprint
• 🪽 Hermes
• ⛏️ Moincraft
• 🧸 AIRI
• 📊 Nexus
• 🧭 Plans
• 🧠 Skills