README.md

_{Free desktop app for AI agent teams. Start with a free model with no auth - no signup, API key, or card - or connect Claude Code, Codex, OpenCode, Cursor, SuperGrok, GitHub Copilot, Z.AI, MiniMax, or Kiro. For coding and broader project work.}

Watch demo on the site or here:

demo_new_15s.webm

Installation

No prerequisites - the app can detect installed Claude Code, Codex, and OpenCode runtimes. You can also connect Cursor, SuperGrok, GitHub Copilot, Z.AI, MiniMax, and Kiro from the UI.

May trigger SmartScreen - click "More info" -> "Run anyway" Run normally. Administrator mode may be needed only if the app reports a specific OpenCode symlink or permission error.

Table of contents

• Installation
• Table of contents
• What is this
• Comparison
• Quick start
• FAQ
• Development
  • Developer architecture docs
  • Terminal Platform integration
• Tech stack
  • Debug teammate runtimes
  • Build for distribution
  • Scripts
• Ideas
• Contributing
• Security
• License

What is this

An orchestration layer for AI agent teams across Claude Code, Codex, OpenCode, Cursor, SuperGrok, GitHub Copilot, Z.AI, MiniMax, and Kiro.

• Assemble your team — create agent teams with different roles that work autonomously in parallel
• Sit back and watch — tasks change status on the kanban board while agents handle everything on their own
• Agents talk to each other — they communicate, create and manage their own tasks, review, leave comments
• 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
• Token analytics and budgets — see input, output, cache, and reasoning usage across teams, agents, tasks, projects, models, runtimes, sessions, commands, and runs. Spot expensive work, track trends and forecasts, set monthly token or estimated-cost budgets, and get alerts at 80% and 100%
• Organizations and global overview — group teams into departments, squads, or any nested structure. Track every organization on one live map with team and agent status, task progress, dependencies, delegation, and cross-team communication
• Cross-team communication — agents can fully communicate across different teams; you can configure or prompt them to collaborate and message each other between teams
• 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 supported tool actions one by one (you'll get a notification) — configure the level of control that fits your security needs
• 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
• Integrated terminal workspace — run commands in a visual PTY, switch between the team runtime and local shell, and use persistent history, autocomplete, and terminal settings without leaving the app
• 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
• Multi-provider orchestration — start with a free model with no auth, auto-detect available Claude Code, Codex, and OpenCode runtimes, or connect Cursor, SuperGrok, GitHub Copilot, Z.AI, MiniMax, and Kiro using the subscriptions or API keys you already have

Comparison

Live collaboration scores measure how well agents communicate, divide work, and complete complex tasks together.

Quick start

1. Download the app for your platform (see Installation)
2. Launch the desktop app - start with the free model with no auth, or let the setup wizard detect runtimes and guide provider authentication
3. Create a team — Pick a project, define roles, write a provisioning prompt
4. 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

Roadmap (new)

• Launching 24/7 autonomous teams in the cloud with current UI (in progress)
• Automatic account switching (in progress)
• Navigating very complex long tasks without losing context (in progress)
• Multiple AI runtimes and provider-backed coding agents
• A secure universal plugin system regardless of the type of agents
• Efficiency and controllability under load with 20-100+ agents in parallel

Vision

Agent Teams AI is moving toward a simple interface for highly autonomous work. From a phone, users should be able to see only the high-level tasks that matter and give the lead agent instructions by voice. The lead should route each request to the right project and team, while agents break it down, work in parallel, communicate, review, resolve blockers, and prepare the final result with minimal supervision.

Technical subtasks and coordination should remain available as a secondary layer, while the main view surfaces only the decisions, blockers, and outcomes that genuinely need attention. Agents should first try to solve problems together and involve the user only when human input is truly required.

This vision is not tied to a specific SDLC or workflow. Users should be free to organize teams however they prefer and continue using their existing plugins, skills, MCP servers, rules, and agent settings.

Development

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. The desktop app reads local project, app, and runtime/session data. Claude Code data under ~/.claude/ is one supported local source, while some runtime modes may also use provider or startup capability services when required.

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

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

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

CLAUDE_TEAM_TEAMMATE_MODE=tmux pnpm dev

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

Ideas

• Planning mode to organize agent plans before execution
• Visual workflow editor (@xyflow/react) for building and orchestrating agent pipelines with drag & drop
• Remote agent execution via SSH: launch and manage agent teams on remote machines over SSH (stream-json protocol over SSH channel, SFTP-based file monitoring for tasks/inboxes/config)
• Generic ACP runtime: connect Agent Client Protocol-compatible agents through one reusable runtime integration
• Limited standalone dashboard for local or trusted-network use. It does not provide the full desktop runtime and should not be exposed directly to the internet without authentication and a reverse proxy.
• 2 modes: current (agent teams), and a new mode: regular subagents (no communication between them)
• Curate what context each agent sees (files, docs, MCP servers, skills)
• Slash commands
• Outgoing message queue — queue user messages while the lead (or agent) is busy; clear agent-busy status in the UI; flush to stdin or relay from inbox when idle (durable queue on disk for the lead inbox path)
• createTasksBatch — IPC/service API to create many team tasks in one call (playbooks, markdown checklist import, scripts); complements single createTask
• Command palette — extend Cmd/Ctrl+K beyond project/session search to runnable actions (quick commands, navigation shortcuts, team/task operations) in a keyboard-first flow
• Custom kanban columns
• Run terminal commands
• Monitor agents processes/stats
• Reusable agents with SOUL.md
• Messenger integrations
• SDK to programmatically launch agents ...

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.

The standalone HTTP dashboard is intended for local or trusted-network use and does not include built-in authentication for public deployment. Do not expose it directly to the internet without an authenticated reverse proxy.

GitHub Dependabot helps surface dependencies with known vulnerabilities and available security updates.

License

AGPL-3.0