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 / 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.
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 · 3D in sync
Switch freely between React Flow 2D and Three.js 3D. Pick any of four layouts (horizontal / vertical / radial / volumetric tree) — independent settings per mode.
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.
Roadmap — what's next
ViewWork's core is "live visualization of code + activity." Here's what we want to layer on top — priorities adjust based on your feedback.
Live database mutation tracking
See INSERT / UPDATE / DELETE on local PostgreSQL / MySQL / SQLite, or cloud DBs (Supabase, Firestore, MongoDB Atlas) pulse on the matching table node the moment they happen — and watch which AI / visitor / user wrote which row.
Direct local + cloud DB access
Register a connection string and ViewWork runs read-only queries — table/column
stats, sample rows, foreign-key topology, missing-index hints. Auto-parses
DATABASE_URL from .env. Secrets stay in OS keychain only.
Watch + alert
Rule-based alerts (desktop notification + Discord webhook) for production anomalies — "1000 inserts on this table in 1 minute," "auth.users hit by many external IPs," "deploy script ran outside business hours."
Time scrubber
Replay the last N hours/days as a timeline. Scrub to the moment a bug appeared — all AI work, dev-server traffic, and file changes from that instant rebuild.
Team mode
Multiple developers' ViewWork instances share the same project. Teammates' avatars + AI agents appear on your map in real time — see who is touching which file, right now.
Live tests + coverage
Jest / Vitest / Playwright runs surface on the nodes they touch. Failing tests highlight the file tree they cover. Node color intensity shows coverage %.
Plugin / SDK
A plugin API for third-party visualization layers — overlay Sentry error streams, show GitHub Actions build status as outer rings around nodes, etc.
Geo visitor tracking
GeoIP-map dev/staging visitors onto a globe view. Real users' page flows jump from code nodes to spots on Earth.
AI agent comparison
Run the same task on multiple AIs and see who edits which file in what order — side-by-side histograms, Gantt charts, heatmaps.
💡 Got an idea? Drop it on Contact or GitHub Discussions.
Read more
The "why" behind ViewWork — motivation, internals, and how to use it.
Download
Free downloads from GitHub Releases. The app auto-checks for updates on launch.
NSIS Installer
DMG
AppImage / deb
Source: github.com/gugu9999gu/ViewWork · README · Release notes