Skip to content

amicode: the amico brain — a live map of the session's thought in the chat - #19

Merged
kateebonner merged 1 commit into
local/amicodefrom
kate/brain-in-chat
Jul 14, 2026
Merged

amicode: the amico brain — a live map of the session's thought in the chat#19
kateebonner merged 1 commit into
local/amicodefrom
kate/brain-in-chat

Conversation

@kateebonner

@kateebonner kateebonner commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

What

A persistent, breathing visualization of amico's neural pathways — the session's real path over the vault/skill/agent graph — living in the conversation flow as a permanent timeline row.

  • At rest: a 72px living slice, close-up on amico's current position.
  • While thinking: expands to a 224px whole-network view (amico core dead center, every node and pathway in frame) and draws the turn's actual tool calls live — reads/skills/edits commit as traveling pulses that claim their category color; searches flash as considered scouts; the interview's questions ring the pulse-designer node.
  • Across turns: completed messages replay instantly into the atlas, so the session's thought-path accumulates; turns with ≥2 commits chart a quiet constellation ("plate N · prompt excerpt").
  • Joins with the log: hovering a tool row or an Explored/shell chip rings its node on the map (and steers the close-up camera to it).
  • Folds while a question dock is open (render loop paused); click toggles; reduced motion honored inside the page.

How

  • packages/app/src/pages/session/brain-strip.tsx — the strip component: session-wide tool-call → touch mapping, replay/chart protocol, auto-breathe, hover forwarding.
  • packages/app/src/pages/session/message-timeline{.tsx,.data.ts} — a Brain timeline row (stable key, kept mounted) with the centered content-column constraint.
  • packages/ui — amicode/brain-ref.ts (tool → node-label/category mapping) + hover hooks on tool-part-wrapper and group triggers.
  • packages/app/public/brain.{html,js} + brain-font.woff2 — the brain page, CSP-split (no inline scripts / data: fonts pass the served-HTML CSP), generated from the canonical design artifact in amicode media/brain/brain.html; re-split to update, don't hand-edit.

Testing

  • bun run typecheck (repo-wide via turbo) and packages/app / packages/ui unit suites green.
  • Brain engine behaviors (live touches, replay restore, charting, pause/resume, glance camera, fit/centering) verified headlessly against the exact served assets with scripted probes and screenshots at both strip heights, light and dark.

🤖 Generated with Claude Code

@kateebonner
kateebonner force-pushed the kate/brain-in-chat branch 5 times, most recently from f3147c7 to 8befeaf Compare July 14, 2026 23:09
@kateebonner @claude
feat(amicode): the amico brain — a live map of the session's thought …
45805c2 
…in the chat

A persistent, breathing visualization of amico's neural pathways rendered
over the vault/skill/agent graph, living in the conversation flow as a
permanent timeline row (stable key, kept mounted, riding the timeline's own
row-measurement and bottom-lock machinery).

Behavior
- Auto-breathe: a 72px living slice at rest (close-up centered on amico's
  current position), expanding to a 224px whole-network view while a turn
  thinks (the amico core anchors dead center, zoom fits the farthest node);
  lingers 5s past completion, then collapses. Click/Enter toggles manually
  until the next turn reclaims auto. Folds entirely while a question dock
  is open — render loop paused, amico is waiting on the user.
- Live telemetry: every tool call of the session streams into the brain.
  Reads, edits, skills, tasks and amicode_* verbs COMMIT — a pulse travels
  the skeleton and the node claims its category color (skill names map onto
  real skeleton node ids; unknown files graft beside the current position);
  greps/globs/lists flash as considered scouts that may leak back to dark;
  the interview's question tool rings the pulse-designer node per question.
- Session persistence: completed messages arrive replay-flagged and restore
  the atlas instantly; the busy message animates live — every turn resumes
  the session's accumulated path. Turns with ≥2 commits chart a quiet
  constellation named "plate N · <prompt excerpt>".
- Spreading activation: each live commit charges up to 4 skeleton neighbors
  sub-threshold, so one event ripples like tissue instead of blipping.
- Cross-links: hovering a tool row (or an Explored/shell group chip) rings
  its node on the map via the amicode:brain-hover event; in the collapsed
  close-up the camera turns briskly to look at the glanced node.

Rendering
- Natively wide force layout for the strip (stretch-then-relax: locally
  isotropic distances inside a wide envelope — no projection squash), all
  pathways drawn clearly, untraversed tissue receded so the traversed path
  owns the contrast, where-we-are cursor ring legible in both themes.
- Assets ship CSP-split (the server forbids inline scripts and data: fonts
  in served HTML): public/brain.html + brain.js + brain-font.woff2,
  GENERATED from the canonical design artifact in amicode media/brain —
  re-split to update, do not hand-edit.
- The card wears the message cards' surface token, hairline border, 12px
  radius, and the centered content-column constraint.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@kateebonner
kateebonner merged commit b1ee28f into local/amicode Jul 14, 2026
0 of 4 checks passed
@kateebonner
kateebonner deleted the kate/brain-in-chat branch July 14, 2026 23:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@kateebonner