Conversational Experience Router

简体中文 | English

An open experience layer for conversational AI. It routes user intents — “I’m bored”, “help me organize this idea”, “I want to chat about something” — into experiences that can start right away.

Claude is the first AI host; other MCP-compatible or similar-protocol hosts can be added later.

Current release: V1.0 Alpha 1. It adds durable local state, audit records, capability allowlists, an isolated module process boundary, and the host-neutral experience-host/v1 JSON adapter. The alpha is ready for protocol and developer integration testing; it is not a hosted public service.

Features

• Intent to experience: discover and recommend experience modules from the current intent and user-approved interest signals.
• Explicit consent: before launching, issue a one-time, short-lived consent token for the chosen module; the experience starts only after the user confirms.
• Stateful sessions: each experience runs as a short session, with continue, submit-event, and finish.
• Extensible: add a module by dropping it into experiences/; no core changes.
• Verifiable registry: Ed25519 module signing, trusted publishers, permission/risk display, and a version-history index.
• Public topics foundation: public topics, optional discussion rooms, reporting, moderation, and blocking — no automatic private messaging or real-person matching.
• Local-first: the experience web server listens on localhost only and is account-free.

Built-in modules

• social-pulse: public topics and potential conversation directions (demo data for now; real matching and private messaging are a later phase).
• three-minute-mystery: a three-minute text deduction game.
• thought-garden: turn scattered ideas into a core thought, assumptions, and next steps.

Install and run

Requires Node.js 20 or newer. Node.js 22.5+ uses the built-in SQLite backend; Node.js 20 falls back to an atomic JSON document store.

npm install
npm run build

Then:

node dist/index.js

The MCP service talks over stdio and also starts a localhost-only web server and public-topics HTTP API at http://127.0.0.1:4317 by default. If the port is taken, an available port is chosen automatically and returned in the launch_experience entrypoint field; set EXPERIENCE_PORT to pin the port.

Alpha runtime settings:

EXPERIENCE_STATE_FILE=./data/experience-router.db
EXPERIENCE_TRUSTED_KEYS=./keys/trusted-keys.json
EXPERIENCE_ALLOWED_CAPABILITIES=text_game,reflection,topic_recommendation
EXPERIENCE_ISOLATE_MODULES=1
EXPERIENCE_MODULES_DIR=./experiences