b0211e5e08
- Updated README to clarify that the app runs entirely locally and added a comprehensive table of contents. - Enhanced the description of the Claude Agent Teams UI to better convey its functionality and target audience. - Improved the SortableTab component to ensure immediate rendering of team colors based on available data. - Filtered out team lead members in the TeamDetailView to streamline member display. - Eagerly patched team data in the state management to improve UI responsiveness and data accuracy.
12 KiB
12 KiB
Claude Agent Teams UI
You're the CTO, agents are your team. They handle tasks themselves, message each other, review each other's code. You just look at the kanban board and drink coffee.
100% free, open source. No API keys. No configuration. Runs entirely locally.
Table of Contents
What is this
Claude Agent Teams UI is a desktop app that turns Claude Code's "Orchestrate Teams" feature into a full task management experience. Create agent teams, watch them work on a kanban board, review their code changes, and stay in control — all running locally on your machine.
Who is this for
- Developers who want AI agents to handle tasks in parallel while they oversee progress
- Teams using Claude Code and needing a shared task board, code review workflow, and team messaging
- Anyone who wants to browse and analyze Claude Code session history without running agents
How it works
- Create a team — Define roles (e.g. lead, frontend, backend) and a provisioning prompt. The app spawns Claude Code sessions as autonomous team members.
- Tasks flow automatically — Agents create tasks, assign each other, move cards, leave comments, and send messages. You see everything on the kanban board in real time.
- Review like in Cursor — When a task is done, you see the diff, approve, reject, or request changes. Agents get notified and can fix issues.
- Stay in control — Send a direct message to any agent, add a comment on a task, or use quick actions on cards whenever you need to clarify or add work.
Key features
| Feature | Description |
|---|---|
| Kanban board | Tasks move through columns as agents work. Drag-and-drop, filters, quick actions. |
| Code review | Full diff view per task. Approve, reject, or request changes. Agents get notified. |
| Team messaging | Agents send direct messages. Inbox, notifications, clarification flags. |
| Tool visibility | See exactly which tools agents used (Bash, Read, Edit, etc.) for each task. |
| Live processes | See which agents are running. Open URLs directly in the browser. |
| Session analysis | Deep breakdown of each Claude session: commands, reasoning, subprocesses. |
More features
- Recent tasks across projects — Browse the latest completed tasks from all your projects in one place
- Solo mode — One-member team: a single agent that creates its own tasks and shows live progress. Saves tokens; can expand to a full team anytime
- Advanced context monitoring — Token breakdown: user messages, CLAUDE.md, tool outputs, thinking text, team coordination. See usage, context window %, and cost per category
- Smart task-to-log matching — Links Claude session logs to tasks by status change timestamps, even when tasks move back and forth
- Zero-setup onboarding — Built-in Claude Code installation and authentication
- Built-in code editor — Edit project files with Git support without leaving the app
- Branch strategy — Choose via prompt: single branch or git worktree per agent
- Team member stats — Global performance statistics per member
- Attach code context — Reference files or snippets in messages, like in Cursor
- Notification system — Configurable alerts when tasks complete, agents need attention, or errors occur
- MCP integration — Built-in mcp-server for Cursor, Claude Desktop, and other MCP clients. 13 tools for task CRUD, kanban, reviews, and messaging — see mcp-server/README.md
Tech stack
Electron, React 18, TypeScript 5, Tailwind CSS 3, Zustand 4. Data from ~/.claude/ (session logs, todos, tasks). No cloud backend — everything runs locally.
Quick start
- Download the app for your platform (see Installation)
- Launch — On first run, the setup wizard will install and authenticate Claude Code
- Create a team — Pick a project, define roles, write a provisioning prompt
- Watch — Agents spawn, create tasks, and work. You see it all on the kanban board
Installation
No prerequisites — Claude Code can be installed and configured directly from the app.
|
May trigger SmartScreen — click "More info" → "Run anyway" |
|
System requirements: macOS 10.15+, Windows 10+, or Linux (glibc 2.28+). Node.js is not required for the desktop app.
FAQ
Do I need to install Claude Code before using this app?
No. The app includes built-in installation and authentication — just launch and follow the setup wizard.
Does it read or upload my code?
No. Everything runs locally. The app reads Claude Code's session logs from
~/.claude/ — your source code is never sent anywhere.
Can agents communicate with each other?
Yes. Agents send direct messages, create shared tasks, and leave comments — all coordinated through Claude Code's team protocol.
Is it free?
Yes, completely free and open source. The app requires no API keys or subscriptions. You only need a Claude Code plan from Anthropic to run agents.
Can I review code changes before they're applied?
Yes. Every task shows a full diff view where you can accept, reject, or comment on individual code hunks — similar to Cursor's review flow.
What happens if an agent gets stuck?
Send a direct message to course-correct, or stop and restart from the process dashboard. If an agent needs your input, you'll get a notification and the task will show a distinct badge on the board.
Can I use it just to view past sessions without running agents?
Yes. The app works as a session viewer — browse, search, and analyze any Claude Code session history.
Does it support multiple projects and teams?
Yes. Run multiple teams in one project or across different projects, even simultaneously. To avoid Git conflicts, ask agents to use git worktree in your provisioning prompt.
Development
Build from source
Prerequisites: Node.js 20+, pnpm 10+
git clone https://github.com/777genius/claude_agent_teams_ui.git
cd claude_agent_teams_ui
pnpm install
pnpm dev
The app auto-discovers Claude Code projects from ~/.claude/.
Build for distribution
pnpm dist:mac:arm64 # macOS Apple Silicon (.dmg)
pnpm dist:mac:x64 # macOS Intel (.dmg)
pnpm dist:win # Windows (.exe)
pnpm dist:linux # Linux (AppImage/.deb/.rpm/.pacman)
pnpm dist # macOS + Windows + Linux
Scripts
| Command | Description |
|---|---|
pnpm dev |
Development with hot reload |
pnpm build |
Production build |
pnpm typecheck |
TypeScript type checking |
pnpm lint |
Lint (no auto-fix) |
pnpm lint:fix |
Lint and auto-fix |
pnpm format |
Format code with Prettier |
pnpm test |
Run all tests |
pnpm test:watch |
Watch mode |
pnpm test:coverage |
Coverage report |
pnpm test:coverage:critical |
Critical path coverage |
pnpm check |
Full quality gate (types + lint + test + build) |
pnpm fix |
Lint fix + format |
pnpm quality |
Full check + format check + knip |
Roadmap
- CLI runtime: Run in headless/console environments (web UI), e.g. VPS, remote server
- Visual workflow editor (@xyflow/react) for building and orchestrating agent pipelines with drag & drop
- Install skills, MCP, and integrations via an intuitive UI, and only for selected agents
- Planning mode to organize agent plans before execution
- Curate what context each agent sees (files, docs, MCP servers, skills)
- Multi-model support: proxy layer to use other popular LLMs (GPT, Gemini, DeepSeek, Llama, etc.), including offline/local models
Links
- Homepage
- Releases
- Issues
- MCP Server — Use Claude Agent Teams UI tools from Cursor, Claude Desktop, and other MCP clients
Contributing
See CONTRIBUTING.md for development guidelines. Please read our Code of Conduct.
Security
IPC handlers validate all inputs with strict path containment checks. File reads are constrained to the project root and ~/.claude. Sensitive credential paths are blocked. See SECURITY.md for details.