Flow는 Claude Code, opencode, pi에서 코딩 에이전트의 작업 상태에 맞춰 움직이는 애니메이션 장면을 터미널에 표시하는 플러그인이다. 불, 파도, 기차, 우주선, 달 위로 떠오르는 지구, 전투 장면 등을 제공하며, 작업이 활발해지면 장면도 바빠지고 에이전트가 사용자의 응답을 기다리면 차분해진다.

장면은 터미널에서 유니코드 블록 문자 등을 이용해 그린다. Claude 데스크톱 앱에서는 이미지를 사용한다. 장면을 프롬프트 위에 띄우거나, Claude Code에서는 대화 기록 옆의 세로 창에, opencode에서는 사이드바에 표시할 수 있다. pi에는 세로 창이 없어 프롬프트 위에만 표시된다.

Claude Code에서는 세션 안에서 다음 명령을 실행해 설치한다.

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

opencode 2.0 이상과 pi에서는 셸에서 각각 다음 명령을 실행한다.

opencode plugin add github:robdmac/flow

pi install git:github.com/robdmac/flow

Claude 데스크톱 앱에서는 Code 탭의 프롬프트 옆 + 메뉴에서 Plugins → Add plugin을 선택하고 robdmac/flow 마켓플레이스에서 flow-scenes를 설치한다. 데스크톱 앱과 Claude Code는 플러그인을 공유하지만, Flow는 로컬 세션에서만 동작하고 클라우드 세션에서는 사용할 수 없다.

기본 자동 모드에서는 작업 시간, 파일 편집량, 명령 실행, 도구 사용, 하위 에이전트 수 등을 바탕으로 장면의 움직임을 조절한다. 작업이 실패하거나 컨텍스트가 거의 차면 장면의 색과 효과도 바뀐다. /flow 명령으로 장면과 강도를 선택하고, 자동 모드와 고정 강도를 전환하거나 낮과 밤, 소리, 표시 위치를 설정할 수 있다. 설정은 세션별로 유지되며 /flow save로 새 세션의 기본값으로 저장한다.

Flow 제작자는 플러그인이 데이터를 수집하거나 서버에 연결하지 않으며, 설정과 장면에 필요한 정보는 로컬에 저장된다고 설명한다. 소리는 기본적으로 꺼져 있고, 켜더라도 afplay를 사용하는 macOS에서만 재생된다. Claude Code에서는 VS Code와 모바일에서 장면을 표시하지 않는다.

호환성 기준은 Claude Code 2.1.289, opencode 2.0.29, pi 1.0.0이다. 이보다 오래된 버전에서도 실행은 되지만 장면이 제대로 동작하지 않을 수 있다. Claude Code의 플러그인 기능은 얼리 액세스이며 API가 릴리스 사이에 바뀔 수 있고, opencode의 터미널 UI 플러그인 API도 변경될 수 있다.