43d2953874
- Added support for lead context usage tracking, allowing retrieval of context window usage for team leads. - Implemented attachment handling in task comments, enabling users to add and manage attachments with size and type validation. - Updated README to include new features related to visual workflow editor and multi-model support. - Improved error handling and validation for task comments and attachments, ensuring a smoother user experience.
9.5 KiB
9.5 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.
What is this
A new approach to task management with AI agents.
- Assemble your team — create agent teams with different roles that work autonomously in parallel
- Agents talk to each other — they communicate, create and manage their own tasks, and leave comments
- Sit back and watch — tasks change status on the kanban board while agents handle everything on their own
- Review changes like in Cursor — see what code each task changed, then approve, reject, or comment
- Full tool visibility — inspect exactly which tools an agent used to complete each task
- Live process section — see which agents are running processes and open URLs directly in the browser
- Stay in control — send a direct message to any agent, drop a comment on a task, or pick a quick action right on the kanban card whenever you want to clarify something or add new work
More features
- Recent tasks across projects — browse the latest completed tasks from all your projects in one place
- Deep session analysis — detailed breakdown of what happened in each Claude session: bash commands, reasoning, subprocesses
- Smart task-to-log matching — automatically links Claude session logs to specific tasks based on status change timestamps, even when a task moves back and forth between states
- Solo mode — a one-member team: a single agent that creates its own tasks, leaves comments, and shows live progress on the kanban board — saves tokens compared to a full team and can be expanded to a full team at any time
- Zero-setup onboarding — built-in Claude Code installation and authentication, ready to go out of the box
- Built-in code editor — edit project files with Git support and other essential features without leaving the app
- Branch strategy control — choose via prompt whether all agents work on a single branch or each gets its own git worktree
- Team member stats — global performance statistics for every member of the team
- Attach code context — reference files or code snippets in your messages, just like in Cursor
- Notification system — configurable alerts when tasks complete, agents need attention, or errors occur
Installation
No prerequisites — Claude Code can be installed and configured directly from the app.
|
May trigger SmartScreen — click "More info" → "Run anyway" |
|
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 on your machine. 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 automatically through Claude Code's team protocol.
Is it free?
Yes, completely free and open source. The app itself 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?
You can send a direct message to any agent at any time to course-correct, or stop and restart it from the process dashboard. If an agent needs your input, you'll get a notification and the task will be marked with a distinct badge on the board so you won't miss it.
Can I use it just to view past sessions without running agents?
Yes. The app works as a session viewer too — 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 your 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:fix |
Lint and auto-fix |
pnpm test |
Run all tests |
pnpm test:watch |
Watch mode |
pnpm test:coverage |
Coverage report |
pnpm check |
Full quality gate (types + lint + test + build) |
TODO
- CLI runtime: Run not only on a local PC but in any headless/console environment (web UI), e.g. VPS, remote server, etc.
- Visual workflow editor (@xyflow/react) for building and orchestrating agent pipelines with drag & drop
- Context management: control and 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
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.