claudz

A visual orchestration layer for Claude Code. Watch pixel-art agents work in an isometric office while Claude reads, writes, and runs commands for you.

What is this?

claudz wraps Claude Code's Agent SDK in a web UI that shows you everything happening under the hood:

• Isometric office with desks, terminals, filing cabinets, meeting rooms, and a break room
• Pixel-art agents that walk between stations based on what tool Claude is using
• Sub-agents spawn as new characters with unique appearances when Claude uses the Agent tool
• Click any agent to see their activity log, status, and current task
• Slash commands with autocomplete for common workflows
• Markdown rendering for clean output with tables, code blocks, and formatting
• All your installed Claude Code plugins show up in the command palette automatically

Install

npm install -g claudz

Requires Claude Code CLI installed and authenticated, and Node.js 18+.

Usage

claudz start

That's it. Opens at http://localhost:3000. First run auto-installs dependencies.

Slash Commands

Type / in the input box to see all available commands:

Built-in: /plan /review /refactor /test /fix /explain /commit /search /doc /perf /security /scaffold

Claude Code native: /compact /init /memory /cost /model /review-pr

Your plugins: All installed Claude Code plugin commands are auto-discovered and searchable.

Each built-in command injects a specialized prompt that guides Claude's approach (e.g., /review tells Claude to check for bugs, security issues, and provide severity-rated feedback).

The Office

The right panel shows an isometric office with multiple zones:

| Zone | What happens here | |------|-------------------| | Dev Zone | 6 desks with monitors — agents type here when writing/editing code | | Server Room | Terminals + server racks — agents go here for Bash commands | | Library | Filing cabinets + bookshelves — agents search here for Read/Grep/Glob | | Meeting Room | Table + whiteboards — sub-agents spawn and plan here | | Break Room | Coffee + water cooler — idle agents wander here |

Controls: WASD/arrows to pan, scroll to zoom, drag to move, R to reset view, click agents for details.

Smart System Prompt

Every request includes a hidden base prompt that makes Claude:

• Read all relevant code before making any changes
• Think about the system holistically — not just the file being edited
• Follow existing design patterns or establish good ones
• Avoid sunk cost fallacy — abandon bad approaches instead of patching them
• Verify changes compile after editing

Development

git clone https://github.com/akshaymysore/claudz
cd claudz
npm install
claudz dev

License

MIT