AgentCraft Documentation

Welcome to AgentCraft

AgentCraft transforms your AI coding workflow into a real-time strategy experience. Watch your agents come alive in an RTS game interface — track and summon agents and subagents, command them, and manage them. Recycle with the intuitive interface you know and love.

What is AgentCraft?

AgentCraft is an open-source tool that reimagines how you interact with AI coding agents. Instead of a plain terminal, you get a full RTS-style command center where each AI agent is a hero unit on a 3D map, complete with missions, fog of war, skill scrolls, and achievements.

AgentCraft works by installing lightweight hooks into your agent CLI (Claude Code, OpenCode, or Cursor). These hooks report session events to the AgentCraft server, which renders everything in a browser-based game UI.

Key Features

Multi-Agent Heroes — Each AI agent appears as a hero on the map with real-time status tracking
Agent Teams — Display Claude Code team configurations with grouped parties
Mission Tracking — Completed missions persist across restarts with AI-generated summaries
Fog of War — Toggle with V to visualize which areas have active heroes
Skill Scrolls — Collectible scrolls on the map that install real agent skills from skills.sh
Achievements — Tiered unlock system with shareable trophy cards
Integrated Terminal — Full PTY terminal in the bottom HUD with multi-tab support
File Explorer — Browse project files in the side panel with search and IDE integration
Git Worktrees — Spawn heroes in different worktrees directly from the UI

Quick Start

npx @idosal/agentcraft

This runs the guided setup: detects your agent CLIs, installs hooks, starts the server on port 2468, and opens the browser UI.

Head to Getting Started for a full walkthrough.

Supported Agents

Claude Code — Full integration with Anthropic's CLI agent (primary)
OpenCode — 75+ models from multiple providers
Cursor — Cursor's agent mode via CLI

Community

Discord — Get help and share feedback
Twitter / X — Follow for updates