Forge: Justin's Workspace + AI Command Center¶
/home/justinwieb/forge on UDev. Self-hosted ops hub: orchestrates a fleet of 9+ machines (Finn/Proxmox, plex, media-server, n8n, frigate, adguard, homeassistant, immich, minecraft) plus a swarm of Claude Code agents.
Bootstrap: read CLAUDE.md first. It defines session startup, code words, security rules, and quick commands.
Top-level layout¶
| Dir | Purpose |
|---|---|
system-map/ |
Shared brain, fleet map, architecture, routing rules. Read every session. |
memory/ |
Daily logs, general knowledge, handoffs, sessions. Append-only daily; topical general. |
.claude/ |
Agents (director, manager, worker, chief-director) and skills (/spawn, /recall, /notify, /save-to-drive, /preview-site, /handoff, etc.) |
scripts/ |
Reusable tools, monitors, integrations, hooks, search, dispatcher. See MEMORY.md "Tools & Pipelines" for the index. |
infra/ |
Infrastructure, context-api/ (FastAPI), n8n/workflows/, mkdocs/, systemd/ units, self-hosted/ configs. |
tasks/ |
Dispatcher queue (pending/ → active/ → completed//failed//_archive/). |
comms/ |
File-based inter-agent comms bus (inbox/, broadcasts/, results/). |
dashboard/ |
Web dashboard on UDev:8099 (auto-refreshes every 30s). |
data/ |
Local databases, context.db (Context API), search/ (semantic index), telegram-chats/. |
logs/ |
Service + monitor logs (monitor-*.log, dispatcher.log, telegram-*.log, integrations/, workers/). Rotation via logrotate. |
sites/ |
Deployable websites + shared scaffold (_shared/, _templates/, gizmo/, justinkrystal.com/, justinsforge.com/). |
brands/ |
Brand projects, nova-design/, gus-outdoor-co/, gus-the-bass/, wiebelhaus-enterprises/. |
clients/ |
Client work, sip-n-serve/, tanner-nappe-insurance/. |
personal/ |
Personal projects, justinwieb/, stupidprojects/. |
docs/ |
Project docs + fleet-docs/ reference set. Browseable at https://mkdocs.justinsforge.com |
assets/ |
Shared media drop. |
notifications/ |
Multi-channel notify outputs. |
Live infrastructure (systemd)¶
forge-context-api, forge-dispatcher, forge-tmux-anchor, forge-inbox-webhook, forge-mkdocs, forge-telegram-bot, forge-telegram-inbox. Cron-driven monitors (scripts/monitors/*-check.sh) every 5–15 min; mount-watchdog every 10; wellness pollers 6/22; nightly search-index rebuild at 03:30; minecraft backup at 04:00.
Markdown viewer¶
All forge .md content (memory, system-map, docs, brands, infra, root) is rendered at https://mkdocs.justinsforge.com (behind Cloudflare Access), tap from phone.
For day-to-day operating instructions, slash commands, hard limits, and code words, see CLAUDE.md.