firewatch-guide

name	firewatch-guide
description	Guides GitHub PR activity workflows using the Firewatch CLI (fw) and MCP server. Use when triaging PRs, responding to review feedback, querying PR activity, or when the user mentions firewatch, PR reviews, PR comments, or review threads.
user-invocable	true
allowed-tools	Read, Bash(fw *), Bash(gh *), Bash(gt *), Bash(git *), Edit, Write

Firewatch Guide

Query GitHub PR activity and manage review feedback using the Firewatch CLI (fw) or MCP tools.

Quick Start

# Check setup
fw doctor

# View status (auth, cache, repo)
fw status --short

# Get per-PR summary
fw --summary

# See unaddressed feedback
fw fb

Core Concepts

Short IDs: Firewatch generates human-friendly short IDs (e.g., @a7f3c) for comments. Use these instead of long GitHub IDs.

JSONL Output: Default output is newline-delimited JSON. Pipe to jq for filtering. Use --no-jsonl for human-readable format.

Auto-sync: Cache refreshes automatically if stale. Use --no-sync to skip or --sync-full to force a full sync.

---

Triage Workflow