README.md

Where teams scale beyond headcount.

The AI Agent Workforce Platform.
Give every team member an AI agent squad — assign tasks, track progress, and let them collaborate autonomously.

Website · Docs · Quick Start · Discord · LinkedIn

What is AgentsMesh?

AgentsMesh is The AI Agent Workforce Platform — where teams scale beyond headcount. Instead of running agents one-at-a-time on your local machine, AgentsMesh lets you spin up remote AI workstations (AgentPods), coordinate multi-agent collaboration through channels and pod bindings, and track everything via integrated task management — all from a single web console.

Individual productivity has peaked. The next frontier is organizational. AgentsMesh turns AI agents from solo tools into a coordinated workforce.

BYOK (Bring Your Own Key) — You provide your own AI API keys. No usage caps. Full cost control.

Features

• AgentPod — Remote AI workstations with web terminal, Git worktree isolation, and real-time streaming. Run multiple concurrent pods.
• Multi-Agent Collaboration — Coordinate agents through channels and pod bindings. Visualize the collaboration topology in real-time.
• Task Management — Kanban board with ticket-pod binding, progress tracking, and MR/PR integration.
• Self-Hosted Runners — Deploy runners on your own infrastructure. Your code never leaves your environment.
• Multi-Agent Support — Claude Code, Codex CLI, Gemini CLI, Aider, OpenCode, and any custom terminal-based agent.
• Multi-Git Provider — GitLab, GitHub, and Gitee integration.
• Multi-Tenant — Organization > Team > User hierarchy with row-level isolation.
• Enterprise Ready — SSO, RBAC, audit logs, air-gapped deployment support.

Getting Started

The fastest way to use AgentsMesh is through our hosted service at agentsmesh.ai — sign up, connect your Git provider, and start running agents in minutes.

1. Install the Runner

The Runner is a lightweight daemon that runs on your machine and executes AI agents locally. Your code stays on your infrastructure.

curl -fsSL https://agentsmesh.ai/install.sh | sh

See the Runner README for more installation options (deb, rpm, Windows, etc.)

2. Login

agentsmesh-runner login

This opens your browser to authenticate. For headless environments (SSH, remote server):

agentsmesh-runner login --headless

For self-hosted deployments, add --server:

agentsmesh-runner login --server https://your-server.com

3. Run

agentsmesh-runner run

Or install as a system service for always-on operation:

agentsmesh-runner service install
agentsmesh-runner service start

Once the runner is online, create an AgentPod from the web console and start coding with your AI agents.

Architecture

AgentsMesh separates control plane from data plane — orchestration commands travel through gRPC with mTLS, while terminal I/O streams through a Relay cluster.

Quick Start

One-Command Setup (Docker)

git clone https://github.com/AgentsMesh/AgentsMesh.git
cd AgentsMesh/deploy/dev
./dev.sh

This starts the full stack: PostgreSQL, Redis, MinIO, Backend, Relay, Traefik, and a local Next.js frontend with hot reload.

Access:

Test Accounts:

Ports are dynamically allocated per worktree. Check deploy/dev/.env for actual values.

# 1. Start infrastructure
cd deploy/dev && ./dev.sh

# 2. Backend (auto-starts in Docker with hot reload)
docker compose logs -f backend

# 3. Frontend (local with Turbopack)
cd clients/web && pnpm install && pnpm dev

agentsmesh/backend:sha-xxxxxxx
agentsmesh/web:sha-xxxxxxx
agentsmesh/web-admin:sha-xxxxxxx
agentsmesh/relay:sha-xxxxxxx

agentsmesh/backend:1.0.0
agentsmesh/backend:1.0

Supported Agents

Tech Stack

Project Structure

AgentsMesh/
├── backend/          # Go API server
├── clients/          # Frontend clients (web, web-admin, desktop)
│   ├── web/          # Next.js frontend
│   ├── web-admin/    # Admin console (Next.js)
│   └── desktop/      # Electron desktop app
├── runner/           # Self-hosted runner daemon (Go)
├── relay/            # Terminal relay server (Go)
├── proto/            # Protocol Buffers definitions
├── ci/               # CI Dockerfiles
├── deploy/
│   ├── dev/          # Docker Compose dev environment
│   └── selfhost/     # Self-hosted deployment guide
└── docs/             # Architecture docs and RFCs

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• Code of Conduct
• Security Policy

License

Business Source License 1.1 (BSL-1.1)

• Change Date: 2030-02-28
• Change License: GPL-2.0-or-later

The BSL allows you to use, copy, and modify the software for non-production purposes. Production use requires a commercial license until the change date, after which the software becomes available under GPL-2.0-or-later. See LICENSE for the full terms and additional use grant.