Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>BoxglowNew to Visual Studio Code? Get it now.
Boxglow

Boxglow

sukima

|
4 installs
| (0) | Free
See what your AI agents (Claude Code, Codex, ...) and your team are working on: open boxglow.json as a diagram of boxes and wires, right inside VS Code.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Boxglow for VS Code

See where your AI agent is in the plan, and what it is waiting for you to decide.

Boxglow keeps a project plan in one file, boxglow.json: tasks are boxes with inputs and outputs, nested without limit. AI agents (Claude Code, Codex, ...) update the file through a CLI or MCP as they start, finish, or need a decision. This extension opens that file as a live diagram inside VS Code.

The whole plan: four major boxes in dependency order (Stage 1 to 4), wires show what feeds what

How a plan is laid out

The Top view shows the whole plan, nested: expand or collapse any box in place with its arrow. Double-click a major box to open it as its own tab. Wires show which output feeds which input, so you can see what is blocked by what.

In View mode the boxes are laid out in dependency order as numbered stages, left to right: each card shows its category, title and state, with its inputs on the left and outputs on the right. Your own layout in the file is untouched and is used in Edit mode.

Top shows the major boxes; a tab shows everything inside one of them

What you see

  • Where the agent is working: the box it is on says "Working" (and the NOW marker shows the box being worked on right now); the top bar counts what is in progress and what needs a decision, and the heading strip names the final deliverable and the first pending decision.
  • What is done and what is not: the card header shows the state: teal for in progress, light for done, slate for new. Green wires carry a finished deliverable, amber wires (and the "Waiting" label on an input) are still waiting.
  • The block tree: the sidebar button opens the whole hierarchy. Jump to a box, or add, rename, move and delete boxes right from the tree.

Inside the API tab, with the block tree: one box in progress, one waiting for a decision

  • Vertical view: switch the flow to top-to-bottom from the zoom panel and read the plan by scrolling, with inputs above each card and outputs below. Ctrl + wheel (Cmd + wheel on a Mac) zooms.

The same API tab as a vertical flow, read from top to bottom

  • Decisions in one place: when an agent asks a question, the box is marked. Pick an option or write an answer in the side panel; the agent reads it from the file and carries on. Your answer stays listed until the agent has picked it up.

Answering an agent's question from the side panel

Working with several agents

  • Edits do not collide: when the file changes while you have unsaved edits, changes to different boxes are merged automatically. Only a box that both sides changed asks you to choose, box by box.
  • Claims (optional, per plan): an agent that starts a box holds it for a while, so other agents and sub-agents leave it alone.

How to use

  1. In your repository: npx boxglow init --name "My project" and npx boxglow setup-agent (installs everything the agent needs: the instructions, the skill, the hooks that inject the plan at session start and remind the agent to record before finishing, the MCP server, and a review subagent; for both Claude Code and Codex). npx boxglow setup-agent --check shows what is installed and the one-time steps left to you.
  2. Ask your agent to "read the README and create the major boxes in Boxglow".
  3. Right-click boxglow.json and choose Boxglow: Open boxglow.json as a diagram (also in the editor title bar and the command palette).

The diagram follows the file: when the CLI or an agent writes it, the view updates. Edits in the diagram (Edit mode) are written back to the file. Light / dark follow the VS Code theme, and the UI is in English or Japanese following VS Code's display language.

Sync, workspaces and hosted agents (optional)

  • Sync between machines: the sync chip in the top bar starts syncing (sign in with GitHub or Google); the plan is kept on https://sync.boxglow.app and received on another machine or in the web app. "Stop syncing / Resume syncing" and "Disconnect this plan on this device" are in the same panel. On Windows the sign-in is stored with DPAPI.
  • Workspaces: the account menu (top right) creates a workspace, invites people with a link (viewer / editor) and puts plans in it so the whole team syncs the same plan.
  • Agents without the file: "Connect Claude Code / Connect Codex" in the account menu writes the config for the hosted MCP server, so an agent on another machine or in the cloud reads and writes the plan on the server.

Good to know

  • Everything stays in your repository: the extension reads and writes boxglow.json. Nothing is uploaded unless you start syncing (off by default).
  • Works without an agent too: you can build and track a plan by hand.
  • The plan format, the CLI, the MCP server and the web app are open source (MIT): https://github.com/sukima-log/Boxglow
  • Web version: https://boxglow.app/

Questions and bug reports: https://github.com/sukima-log/Boxglow/issues

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft