whizmob

See what AI agent systems you've actually built. Scans your machine for agents, skills, MCP servers, and configs — then shows you how they connect.

$ npx whizmob scan
[whizmob] DB updated: 42 total, +42 added, -0 removed
[whizmob] New: code-reviewer, test-runner, deploy-agent, standup, roadmap, ...
[whizmob] Edges: 67 inferred
$ npx whizmob demo --open
Opens an interactive graph of your agents in the browser.

No accounts. No API keys. No config. Everything stays on your machine.

Commands

Click any command to see details and examples.

scanDiscover agents, skills, and MCP servers across all platforms
$ npx whizmob scan
[whizmob] DB updated: 42 total, +42 added, -0 removed
[whizmob] Edges: 67 inferred

Reads config files, then infers connections between components — agents referencing configs, skills invoking other skills, shared state. Connected components get grouped into mobs.

LocationWhat it finds
~/.claude/Agents, skills, MCP servers, settings
~/.cursor/Agents, MCP servers, settings
~/.codex/Skills

Also scans project directories for per-project .claude/ configs.

demo --openInteractive agent graph in your browser
$ npx whizmob demo --open
Generated ~/.whizmob/demo.html (36KB, 3 mobs, 42 components)

Generates a self-contained HTML file with an interactive force-directed graph of your agents. Zero dependencies — opens in any browser. Use --output path for a custom location.

dashboardFull inspector at localhost:3333
$ npx whizmob dashboard
Dashboard running at http://localhost:3333

Three-panel inspector: mob list, force-directed graph, and component detail cards. Plus searchable inventory, import tools, and mob management.

Whizmob Mob Inspector — three-panel layout showing discovered mobs, force-directed graph, and component detail cards
statsSummary counts of everything found
$ npx whizmob stats
42 passports, 3 platforms, 5 mobs, 67 edges
roster -s "query"Search agents by name or purpose
$ npx whizmob roster -s "deploy"
deploy-agent (subagent, claude) — Handles deployment to Vercel
devops-engineer (subagent, claude) — CI/CD pipeline config

Filter by type with --type, platform with --platform, or see mob memberships with --hook.

mob defineGroup agents into a named, portable mob
$ npx whizmob mob define "my-setup" --add code-reviewer test-runner linter

Mobs are named groups of agents, skills, hooks, and configs that work together. Use mob list and mob show <name> to view them.

export <mob>Bundle a mob for transfer to another machine
$ npx whizmob export my-setup
Exported 12 files to ~/.whizmob/exports/my-setup/

Rewrites absolute paths to placeholders, strips secrets and API keys, bootstraps memory files as empty structures. The output is a plain folder with a manifest.json — no binaries, git-friendly. Copy it however you like.

import <bundle>Install agents from a bundle or built-in mob
$ npx whizmob import ./my-setup --dry-run
Preview: 12 files, 2 conflicts, 1 MCP dependency
$ npx whizmob import ./my-setup

Use --dry-run to preview before installing. --param passes content parameters (names, paths) for the new environment. --list shows available pre-built mobs.

update <bundle>Sync upstream changes without losing local edits
$ npx whizmob update ./my-setup
3 upstream-only (auto-applied), 2 local-only (preserved), 1 both-changed (diff shown)

Three-way comparison using content hashes: upstream-only changes auto-apply, local-only changes are preserved, both-changed files show you the diff. Use --dry-run to preview or --force to overwrite.

Getting started

Troubleshooting

Scan fails with a native module error

Missing build tools. macOS: xcode-select --install. Linux: sudo apt install build-essential python3. Then try again.

Scan finds 0 components

Whizmob looks in ~/.claude/, ~/.cursor/, and ~/.codex/. If none exist, there's nothing to find yet.

Demo shows "No mobs discovered yet"

Components exist but don't reference each other. Mobs appear when agents invoke skills or share state. The full inventory is still available via npx whizmob dashboard.