flow

Ambient scenes in your terminal that move with the work your coding agent is doing: a fire, fizzing bubbles, the surf, a ski run, two rockets, a hot-air balloon, a steam engine, a train through the countryside, Tesla's new Roadster out of town onto the freeway, a colony ship behind its shield, the Earth rising over the moon, and a space marine fighting through a 1993 techbase. They run above the prompt of Claude Code (in the terminal or the Claude desktop app), opencode or pi, or in a tall pane beside Claude Code's transcript or in opencode's sidebar.

Each scene is drawn in 24-bit color from Unicode block, quadrant and braille characters, so several pixels share each terminal cell. In the Claude desktop app, which has no character grid to draw into, the same frames are drawn as images.

https://github.com/user-attachments/assets/66673edf-7a52-43c3-b52b-3a804068bc5e

Install

Claude Code, from inside a session:

/plugin marketplace add robdmac/flow
/plugin install flow-scenes@robdmac
/reload-plugins

Installed it before as flow@robdmac? The plugin is now flow-scenes (another plugin had the name flow). Run /plugin uninstall flow@robdmac, then install as above. The command is still /flow. Settings you'd saved in /config don't carry over: set them again, or set them with /flow and /flow save.

Claude desktop, in the Code tab: click + next to the prompt box, then Plugins → Add plugin, add the marketplace robdmac/flow and install Flow (flow-scenes). Manage it later from + → Plugins → Manage plugins. The desktop app and Claude Code share their plugins, so if you've installed Flow in the terminal it's already there. It runs in local sessions, not cloud ones.

opencode (2.0 or later), from your shell:

opencode plugin add github:robdmac/flow

pi, from your shell:

pi install git:github.com/robdmac/flow

Mods are an early-access Claude Code feature, and their API may change between releases (see Compatibility below).

Not loading?

If /flow doesn't exist after installing, run claude --debug and look for a line about hooks modules:

• "the rollout flag (tengu_plugin_hooks_modules) is off": mods from installed plugins are still being rolled out account by account, and yours doesn't have them yet. Update Claude Code (claude update), then turn them on yourself for one launch:

  CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude
  

  (claude -r instead of claude resumes your last session.) To keep it on, add it to ~/.claude/settings.json:

  "env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" }
  

  or export it in your shell profile.

• "saved off by an earlier session": the flag was cached as off and hasn't refreshed yet. Start a new session, or use the setting above.

• "not available on Bedrock/Vertex/third-party providers" or "with a custom ANTHROPIC_BASE_URL": mods only run against the Anthropic API, so Flow can't load there.

• "until workspace trust is accepted": accept the trust prompt for the folder you started Claude in.

The scenes

Every scene has a level from 0 (off) to 10 (as busy as it gets).

This is the beginning of the README. Read the rest at the original. Read the full README ↗