main
TEAHUB panel lists a repo workflows (.github/.gitea) over the API (CORS for this origin) and opens one with a click. Steps are named by their name:, else their action, else their first shell line, and get an emoji by what they do; the trigger is the first node. Export keeps the original file (frame) and name, so a workflow round-trips with only the graph env added. Long chains snake in rows of five; labels truncate with the full name on hover. Checked headless on all 16 teahubxyz/time workflows. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FAqjv3zFxJCi2vHvdEMqCr
🧜♂️ Merman
Possibility graphs with time.
flowchart LR
A["💬"] --> B["🍵💭"] --> C["🔎"] --> G{"🛣️"} --> D["🛠️"] --> E["🧪"] --> F["✅"]
E --> D
E --> H["🚩👤"] --> D
Mermaid tells you which edges exist. Merman tells you what a token does when it hits them, and when.
- Graph = all legal futures. Path = one of them, played through time. Emoji string = a path collapsed to one dimension.
- Projections:
possible(the route you picked),happy(the simple path),trace(what actually happened, interventions included). One graph, never deleted branches. - Learning is a rewrite, not a traversal. Traversal changes where you are; a rewrite (G₀ → G₁) changes what can happen next.
- The graph is not the source of truth.
raw events → semantic keyframes → Merman projection → evidence/replay. Merman is the middle layer: more legible than an event stream, lighter than a full replay.
Lineage: started as mermaid × manim, became user-flow graphs for Teahub. Ported here from matcha/greentea on hb-5 (Oct 2026). Owned by the factory's CEO lane.
What's here
| path | what |
|---|---|
merman/ |
the interactive playground (pick two nodes, enumerate paths, press play) |
merman/v0/ |
the v0 visual editor |
film/ |
the narrated explainer (story.json is the script) |
docs/merman-user-journey.md |
the Teahub happy path, emoji-only |
docs/spec.md |
where it goes next: typed edges, gates, freeze, exits |
ops/, tests/ |
legacy publish route + tests from greentea |
TeaTalk
Emoji are a redundant semantic channel, not decoration. 🍵 Tea/agent · 💭 think · 🔎 inspect · 🛣️ route · 🛠️ work · 🧪 verify · ⏳ wait · 🚩 andon · 👤 human · 🎛️ cockpit · ✅ accepted · 🌱 learn.
Compact checksum: 🍵💭 → 🔎 → 🛠️ → 🧪 → ✅
Description
🧜♂️ Merman — possibility graphs with time: happy paths, traces, gates and rewrites for agent flows. Mermaid is the editable projection; evidence underneath.
2.1 MiB
0 Stars
1 Watchers
0 Forks
Languages
TypeScript
38.8%
JavaScript
29.7%
HTML
19.8%
Python
10.1%
Shell
1.6%