A Mac desktop app that visualizes running Claude Code sessions as an animated Minecraft-style village.
Each session is a tab. Each agent is a voxel character walking between themed zones based on what tool it is using right now - reading files in the library, writing code in the office, searching in the mine, running tests on the farm, committing in the nether portal, and so on.
The village seen from orbit: nine tool-mapped zones on a round island, agents clustered by the zone they are using right now, boats cruising the sea, minor islands dotted around the horizon.
Close look at the grass cap: scattered grass tufts and flowers, signposts in front of each zone, a cluster of agents standing beside the Spawner.
Agents clustered at the Office building. Each character has a name label; the latest action shows up as a speech bubble (here "TaskUpdate ...") and hovering any object opens a tooltip (Office / "Writing or editing code").
Wide-angle view across the water - clouds overhead, boats sailing past, a school of villagers on the shoreline, minor island in the distance.
Dive the camera below the waterline and the scene swaps to an underwater atmosphere: blue-teal fog, the sky hides, a sandy seabed with rocks and seagrass comes into view, and a school of fish drifts past.
Settings dialog. The Install hook and Uninstall hook buttons merge our entries into ~/.claude/settings.json non-destructively, with a diff preview. The manual snippet stays available. Session-list filter and ghost-retirement timer live here too.
Built-in Help dialog. Covers camera / mouse / keyboard controls and a live table of zones pulled from the source, so any future zone addition surfaces automatically.
- Grab the latest
claude-village-<version>-arm64.dmgfrom the releases page. - Drag
claude-village.appto/Applications, then clear Gatekeeper:xattr -d com.apple.quarantine /Applications/claude-village.app. - Launch from Launchpad. Open a Claude Code session in any terminal. The sidebar picks it up within a second.
Optional: in Settings, click Install hook for lower-latency events. See Install for details.
- Install - download, install, troubleshoot
- Usage - what the app does and how to drive it
- Development - stack, clone, dev loop, build, package
- Design - full spec
- Implementation plan - task breakdown
- Progress - live status of tasks
- Wiki - camera + mouse + keyboard reference, zones, hooks, architecture, troubleshooting
Created by Haim Adrian for Claude Code users.