Watch your AI agents
work on your codebase

ViewWork is a desktop app that maps your directory, AI agent activity (Claude Code, Codex, Cursor, Copilot), local IDE work, and dev server traffic into one live 2D / 2.5D / 3D view. See which file each agent reads, which URL it browses, and which DB table it calls — as characters moving across the node graph.

📸 hero screenshot — 3D node map + character activity /web/assets/screenshots/hero.png

Everything in one live view

Not just a tree view. ViewWork combines analysis + watch + tracking + visualization, with character avatars, virtual nodes, and data-flow particles all overlaid on the same map.

🌐

2D · 2.5D · 3D in sync

Switch freely between React Flow 2D, isometric 2.5D, and Three.js 3D. Pick any of four layouts (horizontal / vertical / radial / volumetric tree) on the fly.

🤖

Auto AI agent tracking

Reads session logs from Claude Code, OpenAI Codex, Cursor, GitHub Copilot, and Windsurf — automatically. No hooks to install. Characters move across the map per tool call.

🧠

Off-project activity, too

Tracks WebFetch / WebSearch URLs (per host), LLM thinking, and final text answers as first-class virtual nodes — see what the agent is doing outside your repo.

🗄️

MCP + DB schema built in

Discovers every MCP server in .mcp.json, plus tables and foreign keys from Prisma / Drizzle / SQL migrations — laid out as connected nodes.

👥

Visitor + dev server tracking

A built-in reverse proxy captures every page view, API call, and form submit on your dev server. Open the LAN URL on a phone — that visitor shows up as a character too.

🎨

Custom characters + 3D models

Drop PNG / SVG / GIF / WebP / AVIF avatars per action. Or load a Mixamo .glb / .fbx rig — animation clips are matched to actions automatically.

🔌

i18n + dark / light themes

Built-in Korean / English plus drop-in .json language packs. Dark, light, and system theme modes; five accent colors. The viewport follows instantly.

📦

Local-first, no telemetry

All scanning runs on your machine. No keys, code, or activity logs ever leave ViewWork.

3 steps to start

Install, pick a folder, code as usual.

Install

Grab the installer for your OS in Downloads below — Windows NSIS, macOS DMG, Linux AppImage / deb.

Open a project

Hit Ctrl+O or click the folder icon, pick any directory. The first scan paints the map immediately.

Let your AI work

Use Claude Code / Cursor / Codex on that project as usual. ViewWork picks up tool calls automatically — no hook setup needed.

Screenshots

ViewWork in action.

3D node map with AI agent characters
3D scene — AI agents working on file nodes in real time
2D React Flow graph with cloud / MCP nodes
2D graph — MCP, cloud, and external activity all in one view
Sidebar — AI tracking + live traffic
Sidebar — AI tracking, live traffic, unified display options
Settings modal — theme / language / characters / cache / performance
Settings — six tabs of system controls

Download

Free downloads from GitHub Releases. The app auto-checks for updates on launch.

Source: github.com/leehy/viewwork · README · Release notes