zamirka

Wfwatch — Development skill for Claude Code

Development community

Live terminal view of Claude Code workflows, subagents and sessions.

How to install Wfwatch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open zamirka/wfwatch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Wfwatch does

Live terminal view of Claude Code workflows, subagents and sessions.

Alternatives in Development

  • Nexting — Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC 1.3k ★
  • Zoetrope — Watch a Claude Code session as a live flow graph, in your terminal or your browser 584 ★
  • Mulmoterminal — Run multiple Claude Code and Codex sessions in parallel — a browser terminal grid that shows which agent needs 187 ★

README

wfwatch

[![CI](https://github.com/zamirka/wfwatch/actions/workflows/ci.yml/badge.svg)](https://github.com/zamirka/wfwatch/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) ![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)

A live terminal view of Claude Code [workflows](https://code.claude.com/docs/en/workflows), [subagents](https://code.claude.com/docs/en/sub-agents) and sessions.

[Русская версия](README.ru.md)

A workflow runs dozens of agents in phases while your sessions keep working in other projects. wfwatch shows all of it in a separate terminal: which workflows are running, which phase each one is in and what every agent is doing right now, which sessions are working, waiting for your answer or running a background command. It only reads the files Claude Code already writes, so it never slows down or interrupts anything. Claude Code's own `/workflows` view shows the runs of a session inside that session; wfwatch watches every session in every project at once.

wfwatch is an unofficial tool, not affiliated with or endorsed by Anthropic (see [Disclaimer](#disclaimer)).

![wfwatch: the overview, then a workflow moving on to its next phase, then a session with two subagents](docs/demo.gif)

*All screenshots are made from [synthetic demo data](#try-it-on-demo-data).*

Install

With [uv](https://docs.astral.sh/uv/):

uv tool install git+https://github.com/zamirka/wfwatch

or with [pipx](https://pipx.pypa.io/):

pipx install git+https://github.com/zamirka/wfwatch

To update: `uv tool upgrade wfwatch` or `pipx reinstall wfwatch`. To remove: `uv tool uninstall wfwatch` or `pipx uninstall wfwatch`.

From a clone of the repository:

git clone https://github.com/zamirka/wfwatch
cd wfwatch
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/wfwatch --version

`python -m wfwatch` works too.

Usage

Run it in a terminal of its own, next to Claude C