visual-devflow

Visual DevFlow

Visual DevFlow is a local project dashboard. It watches project files, Git metadata, task events, and agent read/edit focus, then renders them in a browser UI.

Command Location

Resolve the plugin root as the directory two levels above this SKILL.md, then run:

<plugin-root>/bin/visual-devflow

When working from this source checkout, the command can also be run from the repository root:

bin/visual-devflow

User Intents

• If the user asks to enable, start, turn on, or visualize Visual DevFlow for a project, run:

  <plugin-root>/bin/visual-devflow enable --project "$PWD" --open
  

• If the user asks to disable, stop, or turn off Visual DevFlow for a project, run:

  <plugin-root>/bin/visual-devflow disable --project "$PWD"
  

• If the user asks whether Visual DevFlow is running, run:

  <plugin-root>/bin/visual-devflow status --project "$PWD"
  

Agent Events

When Visual DevFlow is enabled and the user benefits from live agent visibility, emit concise events:

<plugin-root>/bin/visual-devflow emit-agent --project "$PWD" --name "Codex" --action editing --file path/to/file

For high-level work:

<plugin-root>/bin/visual-devflow emit-task --project "$PWD" --kind test --status started --name "Run tests" --command "npm test"

Do not emit noisy events for every small read. Emit at meaningful phase changes: starting implementation, editing a file group, running tests, finishing, failing, or going idle.

Behavior

• enable is idempotent. If the project is already enabled, it reports the existing dashboard URL.
• Project-local state is stored under .visual-devflow/ in the enabled project.
• disable stops the project-local server and removes .visual-devflow/agent-env, while keeping historical dashboard data.
• The dashboard binds to 127.0.0.1 by default.