Get started in 5 minutes
From download to your first running agent. No config files, no CLI setup, no terminal splits.
Before you start
- ✓macOS 14+ (Sonoma or later)
- ✓Claude CLI installed
npm install -g @anthropic-ai/claude-code - ✓An active Claude subscription or API key
Download and install
Download the .dmg file, open it, and drag AgentsRoom to your Applications folder. Launch it from Spotlight or the Applications folder.
Tip: AgentsRoom auto-checks for updates. You'll be notified when a new version is available.
Create your first project
Click the + button in the sidebar. Select any folder on your machine — this is where your Claude agents will work. Name your project and assign it to a zone.
Tip: Each project maps to a real folder. Agents run claude in that directory, just like you would in your terminal.
Add your first agent
Inside your project, click Add Agent. Choose a role — Fullstack is a great start. Select a model (Sonnet recommended). Write your prompt and hit Launch.
Tip: Start simple: "Fix the failing tests" or "Add a loading spinner". Get more specific as you learn.
Watch it work
The terminal shows live output — every file read, every edit. Status changes: thinking → coding → done. You get a macOS notification when it finishes.
Tip: You can launch multiple agents at once. Each gets its own terminal and works independently.
Customize your setup
Edit CLAUDE.md directly from AgentsRoom to give agents better context. Change models, adjust permissions, configure hooks. Add more agents with different roles.
Tip: Opus for architecture. Sonnet for dev. Haiku for quick tasks like tests.
Tips & tricks
1.Use Opus for architecture decisions, Sonnet for daily coding, Haiku for quick tasks
2.Group projects by zone (Work, Personal, Side-projects) for better organization
3.Edit CLAUDE.md from AgentsRoom to give agents better project context
4.Enable macOS notifications so you can multitask while agents work
5.Start with one agent per project, add more as you get comfortable
Troubleshooting
"Claude CLI not found"
Install it: npm install -g @anthropic-ai/claude-code. Make sure it's in your PATH.
Agent stuck on "thinking"
Check that your Claude subscription or API key is active. Try running claude in your terminal.
No projects showing
Make sure you selected a valid folder when creating the project. The folder must exist on disk.
Next steps
Ready to start?
Download AgentsRoom and launch your first agent in 30 seconds.
Download AgentsRoomFree — 3 projects, unlimited agents