Nexus Hub — Field Guide

⚡ Quick Launch

✦ CARE Economy

CARE is earned through genuine engagement. It cannot be purchased or farmed. Progress is earned by showing up.

What CARE is for: Earn enough to unlock the Dragon Egg (1,000 CARE). Once hatched, Ignis grows with you across every session.

Session attendance+10

Agent conversation turn+2

Campaign milestone+25

TKEP session stored+15

Dragon interaction+5

Helping another player+20

Dragon Egg threshold: 1,000 CARE. Check your balance on the Dashboard or in the Agent sidebar under Player Save.

🔥 Agent Console

Your primary AI interface. Loads your player save and active cartridge. Every conversation earns CARE.

🔥

agent.html

Talk to any cartridge. Ben routes you. Gamer knows your playstyle. Scholar asks the hard questions. Strategist cuts through noise.

Type help to see all commands
Type player status to see your save
Type swap gamer to switch cores mid-session
Type remember [fact] to add to your player save

agent.html

Command	What it does
help	Show all available commands
player status	Your save — CARE, egg status, dragon, key facts
cartridge status	Active core — name, version, model, token budget
swap <name>	Hot-swap to ben / gamer / scholar / strategist or any cartridge ID
remember <fact>	Add a persistent fact to your player save (carries across sessions)
save	Manually save session to Firestore
clear	Clear chat history (save is separate)

Genesis Knowledge: At session start, Genesis loads recent docs from genesis_knowledge and genesis_corrections in Firestore. Use Genesis Studio to add knowledge — no bridge required.

⚔ Play Adventure

Immersive campaign screen. DM agent runs the story, dragon companion appears in the sidebar, inventory and quests auto-populate.

⚔

gameplay.html

Three-column layout: story in the center, dragon companion on the right, inventory/quests auto-filled from DM tags embedded in the narrative.

The DM agent uses Claude Sonnet — the most capable storyteller
Ignis (dragon companion) runs on Haiku — fast and responsive
Inventory items appear automatically when the DM mentions them

gameplay.html

🐉 Dragon Companion

Ignis. Your elemental dragon. Pixel art. Learns your preferences. Earns CARE. Never paywalled.

🐉

dragon.html

256×256 pixel art canvas. Ignis has 7 elements × 3 form tiers. Chat panel with preference learning. CARE rewards for every interaction.

7 elements: Fire, Water, Earth, Air, Lightning, Shadow, Light
3 form tiers: Hatchling → Young → Elder
Dragon learns your conversation style over time
Egg unlocks at 1,000 CARE

dragon.html

💬 The Lobby

Shared space. Real-time Firestore chat. Summon AI agents mid-conversation.

💬

chat.html

Multiplayer chat room backed by Firestore. Content moderation built in. Type /summon followed by an agent name to bring Watson, Sherlock, or Einstein into the conversation.

Type /summon Watson to bring an agent in
Type /summon Sherlock or /summon Einstein
Messages are moderated — healing-focused platform rules apply

chat.html

⚙ Pipeline Playground

Build multi-step AI reasoning chains. Store TKEP sessions. Semantic recall via Gemini embeddings in Firestore.

⚙

playground.html

8 step types: Prompt, Vision, Critique, Synthesize, Parallel Split, Store TKEP, Recall TKEP, Score. Epistemic Loop architecture. Results chain automatically between steps.

Gemini key required for semantic recall steps
Store step writes to tkep_chunks in Firestore with embeddings
Recall step searches semantically — cosine similarity, not keyword
Use Genesis Studio to promote high-score chunks to genesis_knowledge

playground.html

Epistemic Loop: The pipeline is designed for TKEP — hypothesis → challenge → synthesize → store. Run a session, score it, let it feed Genesis.

📚 Genesis Studio

Feed Genesis knowledge. Ingest books, paste text, promote TKEP sessions, manage corrections. No bridge required — pure Firestore + Gemini.

📚

genesis_studio.html

Five panels: Paste text, Upload file (.txt/.md), Book ingestion, Review knowledge, Corrections, TKEP Import. Everything writes to genesis_knowledge in Firestore.

Gemini key required for embeddings (free at aistudio.google.com)
Hit ⏹ Stop at any time — progress saves automatically
Refresh the page and a Resume banner appears
Rate: 1 chunk/second · ~60 chunks/minute at free tier

genesis_studio.html

01

Get your free Gemini key — go to aistudio.google.com → Get API Key. Paste it in the key panel at the top of the Studio.

02

Choose your ingest method — Paste for short content, Upload File for .txt/.md, Book for long chapters. Set chunk size (800 chars is a good default).

03

Hit Ingest & Embed — a ⏹ Stop button appears. You can stop safely at any time. Progress is checkpointed to localStorage.

04

Review Knowledge — browse what Genesis knows. Green dot = embedded. Red dot = stored without vector (re-run to embed).

05

Agent reads it automatically — next Agent session, Genesis loads the most recent recall_top_k docs from genesis_knowledge at startup.

🧠 Memory

TKEP sessions, cartridge management, recall testing.

🧠

memory.html

Browse your TKEP session history, manage cartridges, test semantic recall queries against your knowledge base.

memory.html

⌂ Dashboard

Home base. Player save overview, CARE balance, active campaigns, quick navigation to every page.

⌂

dashboard.html

CARE balance, dragon status, active campaigns. Quick action grid links to every feature. Always a good home base to return to.

dashboard.html

⚙ Settings

API keys, preferences, account settings. Separate from Dashboard.

⚙

setup.html

Set your Anthropic API key, Groq key, Gemini key, and platform preferences. Keys are stored in localStorage — never sent to our servers.

Anthropic key → Agent Console + preference inference
Groq key → free LLM alternative (Llama 3.3, Qwen3)
Gemini key → Pipeline recall + Genesis Studio embeddings

setup.html

🧬 How Genesis Thinks

What gets loaded into Genesis's context at the start of every Agent session.

SYSTEM PROMPT
  ↳ Cartridge personality (who Genesis is right now)
  ↳ Player save — CARE balance, egg status, key facts
  ↳ genesis_knowledge — top-K docs ordered by timestamp
  ↳ genesis_corrections — overrides (highest priority)

CONVERSATION HISTORY
  ↳ Everything said this session
  ↳ Token budget enforced per cartridge

BACKGROUND (every N turns)
  ↳ Preference inference — extracts key facts about you
  ↳ CARE awarded per turn

The key insight: genesis_corrections always win. If knowledge says one thing and a correction says another, the correction is what Genesis believes. Use corrections to fix factual errors without deleting knowledge.

📦 Cartridge System

Cartridges are Genesis's personality presets. Swap between them mid-session without losing your player save.

Cartridge	What it is	Best for
Ben	Front door router. Reads your save and routes you where you need to go.	Starting every session
Gamer	Universal gaming brain. Knows your playstyle. Never spoils unless asked.	Gaming sessions
Scholar	Socratic guide. Asks probing questions. Grounded in Stoicism + epistemology.	TKEP sessions, philosophy
Strategist	Work + project planning. Asks "what's blocking you?" before offering solutions.	Nexus Hub planning

Custom cartridges: Build your own in Memory → Cartridges. Share with a 6-character code. Import someone else's with the same code.

💾 SAVE_CODE

A compressed snapshot of your session state. Preserves ~80% of context in ~20% of tokens. Works across sessions, models, and devices.

→

What it solves: AI has no memory between conversations. SAVE_CODE compresses your session into a portable string you can paste into any new session to pick up where you left off.

→

How to get one: Ask any agent "generate my SAVE_CODE" at the end of a session. Paste it at the start of the next session to restore context instantly.

→

NFC cards (Phase 2): Your entire player save and SAVE_CODE can be stored on a physical NFC card. Tap to load into any compatible system.

Everything persists. Nothing is lost. This is the platform's core promise. Your player save in Firestore, your knowledge in genesis_knowledge, your dragon's memory — it all carries forward.

Everything persists.Nothing is lost.

Everything persists.
Nothing is lost.