Journey realtime

Skill butterbase-ai/butterbase-skills/skills/journey-realtime

Plugin for Butterbase.ai

Install

npx -y skills add butterbase-ai/butterbase-skills --skill journey-realtime

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use as the realtime build stage of the Butterbase journey. Implements the Realtime section of 02-plan.md by delegating to the realtime skill. Calls manage_realtime (configure) to enable WebSocket subscriptions on the listed tables. Skipped if the plan has no realtime needs.

SKILL.md

2.0 KB, as published. Nobody here has run it

Journey: Realtime

Stage 3h of the guided journey. Enable WebSocket subscriptions per the plan.

When to use

Dispatched by journey when current_stage: realtime.
Directly via /butterbase-skills:journey-realtime.
Skipped (annotated (n/a)) if the plan has no Realtime section.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Inputs

docs/butterbase/02-plan.md — the Realtime section.
docs/butterbase/00-state.md — for app_id.

Procedure

Refresh docs. Call butterbase_docs with topic: "realtime". For WebSocket subscription shape and RLS interaction, also WebFetch https://docs.butterbase.ai/realtime. Skip if cache is fresh.
Read the Realtime section. Print it back: "About to enable realtime on: <tables>. Proceed?". Wait for yes.
Invoke butterbase-skills:realtime via the Skill tool with the realtime plan and app_id. The wrapped skill calls manage_realtime action: configure per table and reminds the user that RLS still applies to subscribed rows.
Verify with manage_realtime action: get.
Append one line to docs/butterbase/04-build-log.md: <ISO timestamp> realtime manage_realtime ok
Tick - [x] realtime in 00-state.md, set current_stage: to the next unchecked stage.
Return to journey orchestrator (or ask "Continue to the next stage? (yes/no)").

Outputs

Realtime configured tables.
One line in 04-build-log.md.

Anti-patterns

❌ Enabling realtime on a table whose RLS hasn't been configured — clients will connect but see no events.