Agent Teams

You're the boss, agents are your team. They handle tasks themselves, message each other, review each other. You just look at the kanban board and drink coffee.

_{Free desktop app for AI agent teams. Start with a free model with no auth - no signup, API key, or card - or connect Claude/Codex/OpenCode provider access for more models. Not just coding agents.}

Watch demo on the site or here:

demo_new_15s.webm

https://github.com/user-attachments/assets/9cae73cd-7f42-46e5-a8fb-ad6d41737ff8

https://github.com/user-attachments/assets/35e27989-726d-4059-8662-bae610e46b42

Installation

No prerequisites - the app can detect supported runtimes/providers and guide setup from the UI.

_{May trigger SmartScreen - click "More info" -> "Run anyway"}
_{Windows required: launch Agent Teams AI as Administrator, especially when using OpenCode runtimes.}

Installation
Table of contents
What is this
Comparison
Quick start
FAQ
Development
- Developer architecture docs
- Terminal Platform integration
Tech stack
Roadmap
Contributing
Security
License

What is this

An orchestration layer for AI agent teams across Claude, Codex, and OpenCode.

Claude + Codex + OpenCode orchestration — start with a free model with no auth immediately, or auto-detect available Claude/Codex/OpenCode runtimes and use the provider access you already have - subscriptions or API keys
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, review, leave comments
Cross-team communication — agents can fully communicate across different teams; you can configure or prompt them to collaborate and message each other between teams
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
Built-in review workflow — easily see how agents review each other's tasks to make sure everything went exactly as planned
Task-specific logs and messages — clearly see agent/runtime logs (tools), actions and messages in isolation for each individual task, making it easy to trace what happened for any assignment
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
Flexible autonomy — let agents run fully autonomous, or review and approve each action one by one (you'll get a notification) — configure the level of control that fits your security needs
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

More features

Task creation with attachments — send a message to the team lead with any attached images. The lead will automatically create a fully described task and attach your files directly to the task for complete context.
Auto-resume after rate limits — when the lead hits a Claude rate limit and the reset time is known, the app can automatically nudge the lead to continue once the cooldown has passed
Deep session analysis — detailed breakdown of what happened in each agent session: bash commands, reasoning, subprocesses
Smart task-to-log/changes matching — automatically links session logs/changes to specific tasks
Advanced context monitoring system — comprehensive breakdown of what consumes tokens at every step: user messages, Claude.md instructions, tool outputs, thinking text, and team coordination. Token usage, percentage of context window, and session cost are displayed for each category, with detailed views by category or size.
Recent tasks across projects — browse the latest completed tasks from all your projects in one place
Zero-setup onboarding — start with the free model with no auth, then connect paid/account providers only when you need them
Multi-language support - choose the app language and preferred agent communication language. Current UI languages: Arabic, Bengali, Chinese, English, French, German, Hindi, Indonesian, Japanese, Korean, Portuguese, Russian, Spanish, Urdu.
Built-in code editor — edit project files with Git support without leaving the app
Branch strategy - choose per teammate at launch: use the main checkout or run selected agents in their own git worktree. You can still spell out branch rules in the provisioning prompt.
Team member stats — global performance statistics per member
Attach code context — reference files or snippets in messages, like in Cursor. You can also mention tasks using #task-id, or refer to another team with @team-name in your messages.
Notification system — configurable alerts when tasks complete, agents need your response, new comments arrive, or errors occur
MCP integration — supports the built-in mcp-server (see mcp-server folder) for integrating external tools and extensible agent plugins out of the box
Post-compact context recovery — when the active runtime compacts its context, the app restores the key team-management instructions so kanban/task-board coordination stays consistent and important operational context is not lost
Task context is preserved — thanks to task descriptions, comments, and attachments, all essential information about each task remains available for ongoing work and future reference
Workflow history — see the full timeline of each task: when and how its status changed, which agents were involved, and every action that led to the current state

Comparison

Feature	Agent Teams	Gastown	Paperclip	Cursor	Claude Code CLI
Cross-team communication	✅ Messages between separate teams	⚠️ Coordination across groups	⚠️ Company-scoped org work	N/A	❌
Agent-to-agent messaging	✅ Native real-time mailbox	✅ Mailboxes + handoffs	⚠️ Comments + @mentions	❌	✅ Team mailbox, no UI
Linked tasks	✅ Tasks can link to and block each other	⚠️ Task deps + grouped work	✅ Goals, parent tasks, blockers	❌	✅ Shared task list
Session analysis	✅ Task logs + token usage	⚠️ Session recall, feed, metrics	⚠️ Run transcripts + cost audit	❌	⚠️ Usage command, no UI
Task attachments	✅ Auto-attach, agents read & attach files	❌ Not task-level	✅ Docs, attachments, work products	⚠️ Chat session only	⚠️ Chat images only
Hunk-level review	✅ Accept / reject individual hunks	❌	❌ Bring your own review	✅	❌
Built-in code editor	✅ With Git support	❌	❌ Control plane, not editor	✅ Full IDE	❌
Full autonomy	✅ Agents plan, assign, work, and review	✅ Coordinator, grouped work, recovery	✅ Wake-up runs + governance	⚠️ Background agents, not teams	✅ Experimental CLI teams
Task dependencies	✅ Tasks wait for blockers automatically	✅ Dependency waves	✅ Blockers + execution locks	❌	✅ Team task deps, no UI
Review workflow	✅ Agents review each other + human review UI	⚠️ Merge queue	✅ Approvals + governance	⚠️ PR/BugBot only	✅ Team review, no UI
Zero setup	✅ Guided runtime setup	❌ Manual CLI stack	⚠️ `npx` + local database	✅	⚠️ CLI + env flag
Kanban board	✅ 5 columns, real-time	❌ Dashboard, not Kanban	✅ 7 columns, drag-and-drop	❌	❌
Execution logs	✅ Tool calls, reasoning, timeline	⚠️ Feed, metrics, dashboard	✅ Run transcripts + audit log	⚠️ Agent chat + terminal	❌
Live processes	✅ View, stop, open URLs in browser	⚠️ Agent health dashboard	⚠️ Manual services + previews	⚠️ Native terminal only	❌
CPU/RAM per teammate	✅ See CPU/RAM history for each live teammate	⚠️ Shows activity/health, not CPU/RAM	⚠️ Shows run status/cost, not CPU/RAM	❌ Remote agent/terminal only	❌
Per-task code review	✅ Accept / reject / comment	⚠️ Merge queue, no diff UI	⚠️ PR/work products, no inline diff	✅ BugBot on PRs	❌
Flexible autonomy	✅ Per-action approvals + notifications	✅ Gates, escalation, recovery	✅ Board approvals, pause, terminate	⚠️ Background agents auto-run commands	✅ Permissions + hooks
Git worktree isolation	✅ Optional	✅ Core primitive	✅ Worktrees / branches	⚠️ Background branches/VMs	⚠️ Manual worktrees
Mixed AI teammates	✅ Claude, Codex, and OpenCode in one team	✅ Many providers, terminal-first	✅ Bring your own agents/runtimes	⚠️ Multi-model agents, no shared team	⚠️ Claude-only experimental teams
Live team map	✅ Map of teammates, tasks, blockers, handoffs, activity, logs	⚠️ Agent tree + feed panels	⚠️ Org chart/status, not a task/log map	❌	❌
Live teammates	✅ Watch teammates work and message them directly	⚠️ Terminal-based agent sessions	⚠️ Agents wake up for runs, then sleep	⚠️ Background agents per task	⚠️ CLI teams, no desktop view
Team workspace	✅ Tasks, logs, Kanban, review, and teammates in one app	⚠️ Mail/feed/dashboard across tools	⚠️ Board + transcripts, less live teammate view	⚠️ IDE chats/tasks, not team view	❌ No desktop UI
Teammate launch status	✅ Know who started, who is stuck, and who replied	⚠️ Session health, less clear message status	⚠️ Run status, not live teammate status	❌	⚠️ CLI mailbox, no visual status
Org chart / governance	⚠️ Roles + approvals, no org chart	⚠️ Roles + escalation	✅ Org chart + board governance	⚠️ Team admin only	❌
Budget controls	⚠️ Cost/token visibility, no hard caps	⚠️ Cost tiers + digest, no hard caps	✅ Per-agent budgets + hard stops	⚠️ Usage + BG spend limits	⚠️ `/usage` + workspace limits
Price	Free OSS UI + free model with no auth, paid providers optional	Free OSS, runtime plans needed	Free OSS, self-hosted + infra	Free + paid usage	Claude plan or API usage

Fact sources checked on May 18, 2026: detailed research notes, Gastown README, Gastown provider guide, Gastown scheduler, Gastown dashboard source, Gastown release, Paperclip README, Paperclip adapters, Paperclip heartbeat protocol, Paperclip org chart, Paperclip OrgChart source, Paperclip budgets, Paperclip runtime services, Paperclip Kanban source, Paperclip work products, Paperclip release, Cursor Background Agents, Cursor Diffs & Review, Cursor Bugbot, Cursor pricing, Claude Code agent teams, Claude Code subagents, Claude Code workflows, Claude Code costs, Claude pricing.

Quick start

Download the app for your platform (see Installation)
Launch the desktop app - start with the free model with no auth, or let the setup wizard detect runtimes and guide provider authentication
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

Use the desktop app as the primary product. The browser/web path is not needed for normal use and does not provide the full desktop runtime, IPC, terminal, provider auth, or team lifecycle behavior.

FAQ

Do I need to install a runtime before using this app?

No. You can start with the free model with no auth right away. If you want Claude, Codex, OpenCode/OpenRouter, or other provider-backed models, the app guides runtime detection/setup and provider authentication from the UI.

What if the Linux app freezes or shows a blank window over RDP?

Some RDP (Remote Desktop Protocol) sessions expose virtual GPU drivers that can break Electron rendering. Launch with `AGENT_TEAMS_DISABLE_GPU=1` to disable Electron hardware acceleration for that run, for example `AGENT_TEAMS_DISABLE_GPU=1 pnpm dev` from source or `AGENT_TEAMS_DISABLE_GPU=1 ./Agent.Teams.AI.AppImage` for AppImage builds.

Does it read or upload my code?

The app is not a cloud code-sync service. It reads local runtime/session data to power the UI, and your project stays on your machine unless you choose a provider/runtime path that sends data to that provider. In `multimodel` mode, startup may also perform runtime access and capability checks before launch.

Can agents communicate with each other?

Yes. Agents send direct messages, create shared tasks, and leave comments - all coordinated by the app's own orchestration layer.

Is it free?

Yes. The app is free and open source, and you can start with a free model with no auth - no registration, API keys, or credit card. If you want more models, connect the provider access you already have, such as Claude, Codex, OpenCode/OpenRouter, or other supported runtimes.

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. Agent Teams also has a nudge system: the app can send a short control message when there is a clear reason to wake an agent up, such as after a known rate-limit cooldown, when a teammate has not synced with its current task or review, or when progress appears stalled. Nudges are guarded and rate limited, so they are meant to help the agent continue, not spam it. If an agent needs your input, you'll get a notification and the task will show a distinct badge on the board.

Does it support multiple projects and teams?

Yes. Run multiple teams in one project or across different projects, even simultaneously. To avoid Git conflicts, enable git worktree isolation for selected teammates when launching the team, and use the provisioning prompt for any extra branch or merge rules.

Development

Developer architecture docs

For feature architecture and implementation guidance:

Canonical standard - docs/FEATURE_ARCHITECTURE_STANDARD.md
Repo working instructions - CLAUDE.md
Feature root guidance - src/features/README.md
Reference implementation - src/features/recent-projects

Tech stack

Electron 40, React 19, TypeScript 5, Tailwind CSS 3, Zustand 4. Data from ~/.claude/ (session logs, todos, tasks). The desktop app works with local runtime/session state, while some runtime modes may also use provider or startup capability services when required.

Build from source

Prerequisites: Node.js 24.16.0 LTS, pnpm 10+

On macOS, official Node.js 24 prebuilt binaries require macOS 13.5+.

hljs language-bash

git clone https://github.com/777genius/agent-teams-ai.git
cd agent-teams-ai
pnpm install
pnpm dev

pnpm dev starts the desktop Electron app. Do not start a browser/web dev server for normal development; that path is limited and is not the supported way to run agent teams locally.

Use pnpm dev:mcp when you want an MCP browser/debugging tool to attach to the current Electron renderer through the local Chrome DevTools Protocol endpoint on 127.0.0.1:9222.

The desktop app auto-discovers Claude Code projects from ~/.claude/.

Terminal Platform integration

Fresh clones install Terminal Platform SDK packages from vendor/terminal-platform, so pnpm install --frozen-lockfile does not require a sibling ../terminal-platform checkout. Those artifacts are pinned in vendor/terminal-platform/manifest.json and can be refreshed from a local Terminal Platform checkout with:

hljs language-bash

CLAUDE_TERMINAL_PLATFORM_ROOT=/path/to/terminal-platform pnpm terminal-platform:pack

For local Terminal Platform development, build Terminal Platform first, then run this app with the same environment variable:

hljs language-bash

CLAUDE_TERMINAL_PLATFORM_ROOT=/path/to/terminal-platform pnpm dev:mcp

When the variable is set, the Electron build aliases Terminal Platform SDK imports to that local checkout and the terminal runtime loads terminal-platform-node from the local native artifact.

Debug teammate runtimes

Development launches use the app-managed process backend for teammates by default. To inspect teammates in tmux panes while debugging, start the desktop app with:

hljs language-bash

CLAUDE_TEAM_TEAMMATE_MODE=tmux pnpm dev

The same override is available per launch from custom CLI args with --teammate-mode tmux. Use this as an operator/debug mode; the default process backend provides stronger app-owned lifecycle, diagnostics, and cleanup for normal team launches.

Build for distribution

hljs language-bash

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            # Current platform

Distribution scripts run the production build and stage the bundled multimodel runtime from runtime.lock.json before packaging. Use pnpm clean:runtime to remove staged runtime files after local packaging.

Scripts

Command	Description
`pnpm dev`	Desktop app development with hot reload
`pnpm dev:mcp`	Desktop app development with hot reload and local CDP debugging on port 9222
`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

Contributing

See CONTRIBUTING.md for development guidelines. Please read our Code of Conduct.

Partnerships

We are open to partnerships and collaboration opportunities. If you see a way to create value together, we are ready to discuss mutually beneficial terms.

Contact: quantjumppro@gmail.com

Security

IPC and standalone HTTP handlers validate IDs, paths, and payload shape at the boundary. Project editing and write operations are constrained to the selected project root, while read-only discovery also accesses local Claude data under ~/.claude/ and app-owned state paths when required. Path traversal and sensitive config/credential targets are blocked. See SECURITY.md for details.

GitHub Dependabot monitors dependencies for known vulnerabilities, so security updates are surfaced quickly and applied in time.

License

AGPL-3.0

agent-teams-ai

Agent Teams

Installation

Table of contents

What is this

Comparison

Quick start

FAQ

Development

Developer architecture docs

Tech stack

Terminal Platform integration

Debug teammate runtimes

Build for distribution

Scripts

Roadmap

Contributing

Partnerships

Security

License

Similar Packages

Security

Tags

Original Author

Publisher