firstmate: Multi-Agent Orchestration via a Single Point of Contact

Repositorykunchenguid/firstmateTool

firstmate is an open-source agent distribution designed to run and coordinate parallel coding agents through a single supervising agent.

Key points

  1. Single liaison: Developers interact exclusively with the 'first mate', which supervises crew agents and reports back outcomes or escalations.
  2. Visible session backends: Crew agents execute inside visible sessions using multiplexers like tmux, Herdr, zellij, cmux, or Orca.
  3. Isolated worktrees: Each task runs in a dedicated Git worktree (via treehouse or Orca) to avoid collision during concurrent work.
  4. Two task models: Distinguishes between 'ship' tasks (delivering code changes/PRs) and 'scout' tasks (standalone research and investigation reports).
  5. Agent distro format: Operates without a standalone installer, relying on AGENTS.md, bundled skills, and Shell scripts loaded by supported terminal agents.
  6. Multi-host scalability: Supports optional 'secondmates' for delegating workloads to separate environments or remote machines via SSH.

Why it matters

Running multiple coding agents simultaneously often results in terminal clutter and context-switching overhead. firstmate streamlines multi-agent task execution by providing automated session management and Git isolation under one coordinating agent.

Analysis

The project targets a growing bottleneck in agent-assisted software engineering: coordinating concurrent automated tasks without creating Git merge conflicts or terminal chaos. By packaging its logic as an 'agent distro' using Shell scripts, Git worktrees, and established terminal multiplexers like tmux, firstmate keeps runtime dependencies lightweight. With over 5,700 stars, it represents a mature, community-backed approach to local multi-agent management for terminal-centric developers.

Mentioned links

Found in

Summary generated by AI (Gemini 3.8 Flash, 27 September 2026). It may contain errors – the original source is authoritative.

Related entries

Similar in content, found by the AI search.

  • Video

    Video:David Ondrej

    Agentic Engineering Setup: Kun Chen's Terminal-Based Multi-Agent Workflow

    In conversation with David Ondrej, former Meta, Microsoft, and Atlassian engineer Kun Chen demonstrates his fully agentic development workflow. Rather than manually juggling dozens of agent sessions, he uses his custom tool FirstMate as a primary coordinator. FirstMate delegates sub-tasks to specialised crewmate agents inside Herder, an agent-aware terminal multiplexer running in WezTerm.

    AI & LLMs· Discussion

  • Repository:stablyai/orca

    Orca: Orchestrating Parallel AI Coding Agents via Git Worktrees

    Orca is an open-source Agent Development Environment (ADE) enabling developers to run multiple AI coding agents such as ClaudeCode, Codex, OpenCode, or Pi side-by-side across isolated Git worktrees with companion desktop and mobile apps.

    60.9kstarsTypeScript

    AI & LLMs· Tool

  • Video

    Video:CURT

    High-Throughput Agentic Engineering by Ex-Meta Principal Engineer

    Kun, former L8 Principal Engineer at Meta, Microsoft, and Atlassian, demonstrates his high-throughput agentic engineering setup. His open-source tool firstmate allows a single lead agent to orchestrate worker agents across dozens of active repositories.

    AI & LLMs· Demo

  • Repository:herdrdev/herdr

    herdr: Terminal Multiplexer and Runtime for Coding Agents

    herdr is a terminal multiplexer written in Rust, built specifically to manage and orchestrate coding agents like Claude Code, Codex, and Cursor. It maintains terminal sessions in the background, tracks agent states, and provides programmatic control interfaces.

    41.3kstarsRust

    AI & LLMs· Tool

  • X post:Kun Chen

    Orchestrating AI Agents: Combining Herdr and Firstmate

    Kun Chen outlines the architectural combination of Herdr and Firstmate for multi-agent workflows. Herdr manages agent lifecycles and organization, while Firstmate acts as the primary orchestrator and single point of contact.

    1kbookmarks74.6kviews

    AI & LLMs· Tool

Back to the knowledge base

Let's talk about your project

Get in touch

Locations

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Vienna
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Parts of this content were created with the assistance of AI.