Overview

Tired of juggling multiple coding agent sessions and manually coordinating tasks across different repositories? Firstmate revolutionizes the way you work with AI agents. Instead of managing individual agents, you interact with a single "first mate" who orchestrates a whole "crew" of autonomous agents. Firstmate handles the heavy lifting, spawning dedicated agents for each task, isolating their work environments, supervising their progress, and delivering completed work in the form of pull requests, local merges, or detailed investigation reports. It's your personal AI fleet commander, enabling you to scale your agent-driven development without the complexity.

Key Features

• Unified Interface: Communicate solely with the first mate, who manages and reports on the entire crew's progress.
• Visible Crew Activity: Monitor each agent's work in real-time within dedicated tmux windows or other supported session backends, allowing for transparency and intervention when needed.
• Isolated Workspaces: Every task is executed in a clean, isolated git worktree (via treehouse or Orca), preventing conflicts and ensuring parallel tasks on the same repository never interfere with each other.
• Flexible Task Execution: Ship tasks for direct code changes (via no-mistakes, direct-PR, or local-only modes) or conduct "scout" tasks to generate standalone investigation reports.
• Scalable Fleet Management: Seamlessly integrate optional "secondmates" for persistent, distributed agent operations, either locally or across SSH-reachable hosts, providing enhanced resilience and management for larger fleets.
• Event-Driven Supervision: A zero-token event-driven watcher intelligently wakes the first mate only when user input is truly required, minimizing noise and maximizing efficiency.
• Restart-Proof Operations: All state is persistently stored on disk and within the active session backend, ensuring that your agent fleet can be resumed seamlessly even after session restarts or system interruptions.
• Optional Relay Integration: Connect with X and Discord to receive public mentions, act on reversible requests, and post completion updates without altering core behavior.

Typical Use Cases

• Parallel Development Tasks: Assign multiple, independent tasks (e.g., bug fixes, feature investigations, code audits) to different agents simultaneously, significantly accelerating development cycles.
• Complex Project Refactoring: Break down large refactoring efforts into manageable sub-tasks, each handled by a dedicated agent, with the first mate coordinating the overall integration.
• Automated Code Audits & Analysis: Deploy scout agents to perform deep dives into codebases, generating comprehensive reports on security vulnerabilities, performance bottlenecks, or architectural adherence.
• Streamlined Code Review: Receive ready-to-review pull requests directly from your agent crew, streamlining the review process and saving valuable developer time.
• Remote Collaboration & Distributed Teams: Leverage secondmates to manage agent fleets across different machines or cloud instances, enabling distributed teams to collaborate effectively with AI assistance.
• Continuous Improvement & Maintenance: Proactively assign agents to monitor for flaky tests, investigate code smells, or implement minor improvements, maintaining a high standard of code quality.