firstmate

Talk to one agent. Ship with a crew.

18 articles 3.5k View on GitHub ↗
18 articles
How Firstmate's Watcher Continuity and Stale Detection Works: A Deep Dive into the Shell Supervision Logic

Discover how Firstmate's watcher ensures continuity and detects stale panes using filesystem locks, heartbeats, and busy-state contracts for robust worker supervision.

deep-dive
Aug 13, 2026
How to Configure the Wedge Alarm for Away-Mode Notifications in Firstmate

Configure Firstmate wedge alarm away mode notifications using config files or environment variables. Customize alerts for away mode escalations.

how-to-guide
Aug 13, 2026
How Firstmate Crew-Dispatch Profiles Route Tasks to the Right LLM Harness

Discover how Firstmate crew-dispatch profiles map tasks to LLM harnesses using ordered rules and fallback defaults. Learn how Firstmate resolves ambiguous matches for efficient routing.

deep-dive
Aug 13, 2026
How Turn-End Guard and Sub-Agent Guard Backstops Work in Firstmate

Understand how Firstmate's turn-end guard and sub-agent guard backstops prevent unsupervised turn endings and unauthorized delegation. Learn about these essential safety features.

internals
Aug 13, 2026
Firstmate Hard Rules and Project Boundary Restrictions

Understand Firstmate hard rules and project boundary restrictions. Learn how Firstmate prevents unauthorized project writes, PR merges, and protects private data.

how-to-guide
Aug 13, 2026
How to Configure the FirstMate Backlog Backend with Tasks-Axi or Manual Mode

Configure the FirstMate backlog backend for tasks-axi or manual mode. Learn how to set your work item rendering by editing the backlog-backend file.

how-to-guide
Aug 13, 2026
How Trace Context Propagation Works Across Firstmate Secondmates

Discover how Firstmate enables W3C trace context propagation across processes, including nested and remote secondmates, by injecting a single traceparent carrier via the TRACEPARENT environment variable.

deep-dive
Aug 13, 2026
How the Away-Mode (/afk) Sub‑Supervisor Functions in Firstmate

Learn how the firstmate away-mode /afk sub-supervisor buffers escalations while you're away. Discover its presence-gated bash daemon functionality and graceful shutdown.

internals
Aug 13, 2026
Supervision Protocols for Firstmate Harnesses: Claude, Grok, and Pi Explained

Understand Firstmate harness supervision protocols for Claude Grok and Pi. Learn about stop-hook background-notification and extension-owned background wakes for efficient sequence management.

deep-dive
Aug 13, 2026
How to Configure Quota-Based Dispatch and Profile Selection in Firstmate

Learn to configure quota-based dispatch and profile selection in Firstmate. Set up your crew-dispatch.json file and enable automatic, quota-aware profile selection for efficient resource management.

how-to-guide
Aug 13, 2026
Firstmate's Treehouse Worktree Isolation: How It Prevents Git Conflicts

Learn how Firstmate's treehouse worktree isolation prevents Git conflicts. Discover how disposable worktrees and tangle guards ensure safe concurrent task execution and protect your primary repository.

internals
Aug 13, 2026
How Firstmate Handles Stuck or Unresponsive Crewmates: Recovery Playbook Explained

Firstmate's stuck-crewmate-recovery playbook ensures crewmate state is reconciled and unlanded work preserved before interrupting or relaunching actions. Learn how Firstmate keeps your operations running smoothly.

how-to-guide
Aug 13, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →