@idosal/agentcraft
v0.1.5
Published
RTS agent orchestrator
Downloads
1,288
Maintainers
Readme
AgentCraft
The agent orchestrator you've trained for.
Watch your agents come alive in an RTS game interface. Track and summon agents, command them, and manage their lifecycle with the intuitive interface you know and love.
https://www.getagentcraft.com/demo.mp4
Quick Start
npx @idosal/agentcraftThis opens AgentCraft in your browser. From there you can:
- Summon AI agents as heroes
- Command them with missions and watch them execute
- See real-time progress, file operations, and results
- Manage multiple agents working in parallel
How It Works
All your agents in one place. See them work, launch new agents, and manage their lifecycle with the RTS muscle memory you already have.
In addition to summoning agents internally, AgentCraft also visualizes external sessions from your terminal.
┌─────────────────┐ ┌─────────────────┐
│ AgentCraft │ ───── summons ────▶ │ AI Agents │
│ (Browser) │ ◀──── reports ──── │ (Heroes) │
└─────────────────┘ └─────────────────┘Commands
npx @idosal/agentcraft # Launch AgentCraft
npx @idosal/agentcraft start -d # Start in background (daemon mode)
npx @idosal/agentcraft stop # Stop the server
npx @idosal/agentcraft status # Check server status
npx @idosal/agentcraft open # Open browser to running server
npx @idosal/agentcraft doctor # Diagnose issuesRunning in Your Project
Start AgentCraft from your project folder:
cd ~/my-project
npx @idosal/agentcraftAgents you summon will work in that directory - reading files, making changes, running commands.
Features
Single Pane of Glass
All your agents in one place. See your agents work, launch new agents, and manage their lifecycle.
Total Control
The interface that made managing 200 units possible is now ready for AI. Quickly react to events that require your attention.
Mission System
Assign tasks to your agents. Watch missions unfold in real-time with auto-generated quest names. Tasks running a bit long? Explore the map!
Multi-Agent Coordination
Run multiple agents in parallel. Each hero operates independently - have one agent refactoring code while another writes tests.
Requirements
- Node.js 18+
Supported Agents
Starting with Claude Code, with more agent types coming soon.
Troubleshooting
npx @idosal/agentcraft doctorThis checks your setup and reports any issues.
Common Issues
"Port 2468 in use"
npx @idosal/agentcraft stop
# or use a different port
npx @idosal/agentcraft start --port 3002Uninstalling
npx @idosal/agentcraft uninstallRemoves AgentCraft hooks. Does not affect your projects or installed agents.
Privacy
AgentCraft runs 100% locally. Your code and agent interactions (e.g., prompts) never leave your machine.
Links
- Website: getagentcraft.com
