v0.1.0 — Initial Public Release

Mana Hub v0.1.0 — Initial Public Release

First public release of the Mana Hub Core — a self-hosted operations dashboard for your own AI agents.

Built for the course "Dein AI-Team in 3 Tagen" and for everyone who wants to run their own multi-agent setup on infrastructure they own. Postgres + Next.js + Claude Code + your own Mac.

5-minute quickstart (demo mode, zero secrets)

git clone https://github.com/jesse-media/mana-hub.git mana-hub
cd mana-hub
cp .env.example .env.local
npm install
npm run doctor
npm run dev

Open http://localhost:3000/login and choose Open Local Demo.

What's in the box

• Dashboard (Next.js 16 + React 19 + Tailwind v4) with a full Demo Mode that boots without a Supabase project.
• Bridge connector with two modes: inline (Bridge handles the LLM call) and file_drop (Bridge talks to a Claude Code session running in tmux).
• Risk Approval system with one-time and Allow always policies. Sensitive agent actions stop and wait for your decision; "Allow always" stores a reusable policy with full audit trail.
• Cron-Request workflow — agents propose new cron jobs, you approve / edit / reject in the dashboard.
• Web-Push notifications (VAPID) for new approvals and cron requests, even when the dashboard tab is closed.
• In-app Documentation page rendering a 14-module Lastenheft (spec sheet) and every docs/*.md file as a read-only Markdown viewer with hash routing and search.
• Knowledge Base integration following the Karpathy-Wiki Markdown-tree pattern — point MANA_HUB_KNOWLEDGE_ROOT at any folder.
• Mobile-first polish: bottom tab bar (Dashboard / Chats / Inbox / Health / Theme), safe-area-aware layout, responsive grids on every page.
• Backend adapter boundary: createServerSupabase() + requireAuth() is the single point to swap backends later.
• Install Helper Cursor skill that walks you through Supabase setup, env config, agent boilerplate, and npm run doctor.
• Speedrun skill for experienced users (~30 min setup).
• Agent boilerplate templates with CLAUDE.md / MEMORY / CURRENT structure, MCP examples, per-agent .env.example, start.sh.example.
• Doctor script (npm run doctor) that runs required + advisory health checks for fresh installs.
• CI: lint + typecheck + build + doctor on every push and PR.
• Idempotent Supabase migrations — every migration is safe to re-run.
• Issue and PR templates, Code of Conduct, Contributing guide, Security policy.

Security & privacy

• .env.local and bridge/.env are git-ignored. The repo ships only .env.example placeholders.
• Service-role key only on the server, never bundled into the client.
• Path-traversal hardening on the in-app docs API.
• Service-token-protected internal push endpoint.
• No personal data, customer data, real prompts, or production logs in the public repo — verified with a secret + path scan over the whole tree before publishing.

Demo Mode hardening

MANA_HUB_DEMO_MODE=true (the default in .env.example) makes both server-side and browser Supabase clients short-circuit to a no-op stub. You can boot the dashboard, click around every page, watch the chat, and trigger demo data without any Supabase credentials at all. Heartbeats, activity, knowledge, and chat APIs all respect demo mode.

Mobile experience

• Brand-new bottom tab bar with five quick actions and an agent picker sheet for fast cross-agent chat switching. Respects safe-area-inset-bottom so it never overlaps the iOS home indicator.
• Streamlined sidebar with proper labels and full safe-area padding.
• Chat sized to 100svh minus the tab bar — no more cropped input.
• Global responsive guards in globals.css clamp inline grid patterns and oversized horizontal padding so every page wraps correctly under 720px / 480px.

Course materials

• PRE-COURSE-SETUP.md is the binding pre-flight checklist (Teil A is mandatory before the live agent lessons).
• templates/agent-boilerplate/ is the agent skeleton copied to ~/agents/<name>/ in Module 3.1.
• templates/launchagents/ provides per-agent macOS LaunchAgent install scripts (Module 3.5).
• templates/knowledge-base/ is the Karpathy-Wiki-pattern KB stub (Module 4.1).
• bridge/launchd/ provides the macOS LaunchAgent for the bridge itself.

Documentation

Topic	File
Pre-flight checklist	PRE-COURSE-SETUP.md
Fresh-install verification	docs/fresh-install-checklist.md
Per-agent setup	docs/agent-setup.md
Bridge modes (inline vs file_drop)	docs/bridge-modes.md
Bridge persistence (LaunchAgent / tmux)	docs/bridge-persistence.md
Risk-Approval pipeline	docs/risk-approval.md
Cron + Briefings	docs/cron-and-briefings.md
Cron-Request workflow	docs/cron-system.md
Web-Push (VAPID)	docs/web-push.md
Backend adapters	docs/backend-adapters.md
Update safety	docs/update-safety.md + UPGRADE.md

License

Mana Hub is published under the Mana Hub Community License (LICENSE.md) for personal, educational, and internal business use. Reselling, hosting as SaaS, rebranding, or running a managed service requires a commercial license — see COMMERCIAL-LICENSE.md.

Verified before release

• ✅ npm run lint clean
• ✅ npm run typecheck clean
• ✅ npm run build clean
• ✅ npm run doctor — all required checks PASS
• ✅ npm audit — 0 vulnerabilities
• ✅ Secret + private-data scan over the whole tree

---

Full changelog: see CHANGELOG.md.