Knoxx

Roadmap: ROADMAP.md — this repo's slice. The hub, with the seam, ownership table and sequencing rule, is eta-mu/ROADMAP.md.

Knoxx is a local-first knowledge operations and agent workbench. It combines a shadow-cljs/Fastify backend, a shadow-cljs + React frontend, a JVM Clojure ingestion worker, contract-backed policy/actor/model definitions, and adapters for OpenPlanner, Proxx, MCP, voice, Discord, studio/audio, translation, and workspace tooling.

The name comes from Fort Knox: a secure vault for a team's knowledge. The garden motif comes from digital-garden publishing and curated knowledge spaces.

Built with GLM-5 — part of the z.ai startup ecosystem and the Ussyverse.

Current architecture

┌────────────────────────────┐
│ Frontend                   │
│ shadow-cljs router + React │
│ Vite-built TS bridges      │
│ dev HTTP :5173             │
└──────────────┬─────────────┘
               │ /api, /ws, /health
               ▼
┌─────────────────────────────────────────────────────────────┐
│ Backend                                                     │
│ Node 22 + shadow-cljs + Fastify on :8000                    │
│ auth/RBAC, contracts, agent runtime, MCP facade, API proxy  │
└──────┬─────────────┬─────────────┬──────────────┬──────────┘
       │             │             │              │
       ▼             ▼             ▼              ▼
┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────────┐
│ Proxx    │   │ Ingestion│   │ Redis/PG │   │ OpenPlanner  │
│ models   │   │ Clojure  │   │ sessions │   │ memory/graph │
│ :8789    │   │ :3003    │   │ policy   │   │ :7777        │
└──────────┘   └──────────┘   └──────────┘   └──────────────┘

Repository layout

knoxx/
├── backend/        # Node + shadow-cljs + Fastify backend
│   ├── src/cljs/knoxx/backend/
│   │   ├── domain/ # Agent, contracts, Discord, MCP, media, voice domains
│   │   ├── infra/  # HTTP routes, config, DB, Redis, stores, lifecycle
│   │   ├── shape/  # Route/tool/session shape helpers
│   │   └── runtime/# Process-local runtime state
│   └── test/cljs/  # cljs.test backend tests
├── frontend/       # shadow-cljs browser app + React/TS bridge components
│   ├── src/cljs/knoxx/frontend/ # CLJS routing and migrated pages
│   └── src/                  # React pages, components, API clients, tests
├── ingestion/      # JVM Clojure ingestion service and source drivers
├── contracts/      # EDN contracts for actors, roles, capabilities, models, etc.
├── kanban/         # Agent task board (markdown cards) — source of truth for work items
├── docs/           # Current design docs, audits, reports, and notes
├── cms/            # Folder-backed CMS drafts/content
├── discord-bot/    # Optional standalone Discord bot package
├── Audio/, Voice/, Graphics/, Symmetry/ # local creative/media workspaces
├── ecosystem.config.cjs # PM2 host-dev stack
└── scripts/        # repo checks and helper scripts