gh-pr-attach-screenshots 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan Ong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# gh-pr-attach-screenshots
+
+Upload local screenshots with [`gh-image`](https://github.com/drogers0/gh-image) and attach them to a GitHub PR description.
+
+Manages a `## Screenshots` section delimited by HTML comments so the tool can be run multiple times without duplicating images:
+
+```markdown
+## Screenshots
+
+<!-- agent-screenshots:start -->
+
+![screenshot](https://github.com/user-attachments/assets/...)
+
+<!-- agent-screenshots:end -->
+```
+
+## Prerequisites
+
+Both tools must be installed before running.
+
+**GitHub CLI (`gh`)**
+
+```sh
+brew install gh    # macOS
+gh auth login
+```
+
+See [cli.github.com](https://cli.github.com) for Linux/Windows install options.
+
+**`gh-image` extension**
+
+```sh
+gh extension install drogers0/gh-image
+```
+
+> This step may need to run **outside any sandbox** — the extension stores credentials
+> under `~/.config/gh` and may read browser session tokens.
+
+## Installation
+
+```sh
+npm install -g gh-pr-attach-screenshots
+```
+
+Or use it directly with `npx`:
+
+```sh
+npx gh-pr-attach-screenshots ./screenshot.png
+```
+
+## Usage
+
+```
+gh-pr-attach-screenshots [--pr <number|branch|url>] [--repo owner/repo] [--replace] <image...>
+
+Options:
+  --pr <value>    PR number, branch name, or URL (defaults to current branch PR)
+  --repo <value>  Repository in owner/repo format (defaults to current repo)
+  --replace       Replace existing screenshots instead of merging
+  --help, -h      Show this help message
+```
+
+**Examples**
+
+```sh
+# Attach a screenshot to the current branch's PR
+gh-pr-attach-screenshots ./desktop.png
+
+# Attach multiple screenshots
+gh-pr-attach-screenshots ./desktop.png ./mobile.png
+
+# Replace existing screenshots
+gh-pr-attach-screenshots --replace ./new-desktop.png
+
+# Specify a PR and repo explicitly
+gh-pr-attach-screenshots --pr 123 --repo owner/repo ./screenshot.png
+```
+
+## Programmatic API
+
+```ts
+import { attachPrScreenshots, parseArgs, upsertScreenshotsSection } from "gh-pr-attach-screenshots";
+
+// Full attach flow
+attachPrScreenshots({
+  images: ["./screenshot.png"],
+  pr: "123",
+  repo: "owner/repo",
+  replace: false,
+});
+
+// Parse CLI args
+const options = parseArgs(["--pr", "123", "./screenshot.png"]);
+
+// Upsert the screenshots section in a PR body string
+const newBody = upsertScreenshotsSection(existingBody, imageMarkdown, { replace: false });
+```
+
+## Agent skill
+
+Install this skill so your AI agent automatically knows how to use this tool:
+
+```sh
+npx skills add jonathanong/gh-pr-attach-screenshots -a claude-code
+```
+
+The [`skills`](https://www.npmjs.com/package/skills) CLI supports many agents besides Claude Code — pass a different `-a` flag for OpenAI Codex, Cursor, and others. The skill covers invocation, prerequisites, and the browser-screenshot recipe.
+
+## Agent usage notes
+
+This tool is designed for use by AI agents. Key behaviors:
+
+- **Fail-fast**: if `gh` or the `gh-image` extension is missing, the tool exits immediately with actionable install instructions.
+- **Idempotent**: running the tool multiple times merges images without duplicates.
+- **Success feedback**: after a successful attach, the tool prints to stderr:
+  ```
+  Attached N screenshot(s) to PR #<number> in <owner>/<repo>
+  ```
+- **Exit codes**: `0` on success or `--help`, `2` on error.
+
+## Development
+
+```sh
+pnpm install
+pnpm build        # compile src/*.mts → dist/*.mjs
+pnpm typecheck    # type-check src + test
+pnpm lint         # oxlint
+pnpm format       # oxfmt
+pnpm test         # run tests
+pnpm test:coverage  # run tests with 100% coverage gate
+```

package/dist/attach.d.mts

@@ -0,0 +1,5 @@
+import { type CommandRunner } from "./github-cli.mjs";
+import { type AttachScreenshotOptions } from "./parse-args.mjs";
+export type { AttachScreenshotOptions };
+export declare function attachPrScreenshots(options: AttachScreenshotOptions, runner?: CommandRunner): string;
+//# sourceMappingURL=attach.d.mts.map

package/dist/attach.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.mts","sourceRoot":"","sources":["../src/attach.mts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAMnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAGhE,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,EAChC,MAAM,GAAE,aAA0B,GACjC,MAAM,CAwBR"}

package/dist/attach.mjs

@@ -0,0 +1,22 @@
+import { existsSync } from "node:fs";
+import { editPrBody, ensureGhImageExtension, gh, runCommand, validateGh, } from "./github-cli.mjs";
+import { upsertScreenshotsSection } from "./screenshots-section.mjs";
+export function attachPrScreenshots(options, runner = runCommand) {
+    validateGh(runner);
+    ensureGhImageExtension(runner);
+    const repo = options.repo ??
+        gh(runner, ["repo", "view", "--json", "nameWithOwner", "--jq", ".nameWithOwner"]);
+    const pr = options.pr ?? gh(runner, ["pr", "view", "--repo", repo, "--json", "number", "--jq", ".number"]);
+    const imageMarkdown = options.images.map((image) => {
+        if (!existsSync(image)) {
+            throw new Error(`Screenshot not found: ${image}`);
+        }
+        return gh(runner, ["image", image, "--repo", repo]);
+    });
+    const body = gh(runner, ["pr", "view", pr, "--repo", repo, "--json", "body", "--jq", ".body"]);
+    const nextBody = upsertScreenshotsSection(body, imageMarkdown, { replace: options.replace });
+    editPrBody(runner, pr, repo, nextBody);
+    process.stderr.write(`Attached ${imageMarkdown.length} screenshot(s) to PR #${pr} in ${repo}\n`);
+    return nextBody;
+}
+//# sourceMappingURL=attach.mjs.map

package/dist/attach.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.mjs","sourceRoot":"","sources":["../src/attach.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAEL,UAAU,EACV,sBAAsB,EACtB,EAAE,EACF,UAAU,EACV,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAIrE,MAAM,UAAU,mBAAmB,CACjC,OAAgC,EAChC,SAAwB,UAAU;IAElC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,MAAM,IAAI,GACR,OAAO,CAAC,IAAI;QACZ,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACpF,MAAM,EAAE,GACN,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAElG,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACjD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,wBAAwB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7F,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,aAAa,CAAC,MAAM,yBAAyB,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;IAEjG,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(args: string[]): void;
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","sourceRoot":"","sources":["../src/cli.mts"],"names":[],"mappings":";AAIA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAWzC"}

package/dist/cli.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { attachPrScreenshots } from "./attach.mjs";
+import { HelpRequested, parseArgs } from "./parse-args.mjs";
+export function main(args) {
+    try {
+        attachPrScreenshots(parseArgs(args));
+    }
+    catch (error) {
+        if (error instanceof HelpRequested) {
+            console.log(error.message);
+            process.exit(0);
+        }
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(2);
+    }
+}
+if (process.argv[1] === import.meta.filename) {
+    main(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sourceRoot":"","sources":["../src/cli.mts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,UAAU,IAAI,CAAC,IAAc;IACjC,IAAI,CAAC;QACH,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/github-cli.d.mts

@@ -0,0 +1,14 @@
+export type CommandResult = {
+    error?: Error;
+    status: number | null;
+    stderr: string;
+    stdout: string;
+};
+export type CommandRunner = (command: string, args: string[]) => CommandResult;
+export declare function runCommand(command: string, args: string[]): CommandResult;
+export declare function formatCommandError(command: string, result: CommandResult): string;
+export declare function gh(runner: CommandRunner, args: string[]): string;
+export declare function validateGh(runner: CommandRunner): void;
+export declare function ensureGhImageExtension(runner: CommandRunner): void;
+export declare function editPrBody(runner: CommandRunner, pr: string, repo: string, body: string): void;
+//# sourceMappingURL=github-cli.d.mts.map

package/dist/github-cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-cli.d.mts","sourceRoot":"","sources":["../src/github-cli.mts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,CAAC;AAE/E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAYzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAGjF;AAED,wBAAgB,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAMhE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAiBtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAmBlE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAS9F"}

package/dist/github-cli.mjs

@@ -0,0 +1,75 @@
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const extensionName = "drogers0/gh-image";
+export function runCommand(command, args) {
+    const options = {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+    };
+    const result = spawnSync(command, args, options);
+    return {
+        error: result.error,
+        status: result.status,
+        stderr: result.stderr ?? "",
+        stdout: result.stdout ?? "",
+    };
+}
+export function formatCommandError(command, result) {
+    const detail = (result.error?.message ?? result.stderr.trim()) || result.stdout.trim();
+    return detail ? `${command} failed: ${detail}` : `${command} failed.`;
+}
+export function gh(runner, args) {
+    const result = runner("gh", args);
+    if (result.status !== 0) {
+        throw new Error(formatCommandError(`gh ${args.join(" ")}`, result));
+    }
+    return result.stdout.trim();
+}
+export function validateGh(runner) {
+    const result = runner("gh", ["--version"]);
+    if (result.error !== undefined || result.status !== 0) {
+        throw new Error([
+            "`gh` (GitHub CLI) is not installed or not on PATH.",
+            "",
+            "Install it:",
+            "  macOS:   brew install gh",
+            "  Linux:   https://github.com/cli/cli#installation",
+            "  Windows: winget install --id GitHub.cli",
+            "",
+            "Then authenticate:",
+            "  gh auth login",
+        ].join("\n"));
+    }
+}
+export function ensureGhImageExtension(runner) {
+    const result = runner("gh", ["extension", "list"]);
+    if (result.status !== 0) {
+        throw new Error(formatCommandError("gh extension list", result));
+    }
+    if (result.stdout.includes(extensionName) || /^gh-image\b/m.test(result.stdout)) {
+        return;
+    }
+    throw new Error([
+        "The `gh-image` extension is not installed.",
+        "",
+        "Install it (this may need to run outside any sandbox, as the extension",
+        "stores credentials under ~/.config/gh):",
+        "  gh extension install drogers0/gh-image",
+        "",
+        "Project: https://github.com/drogers0/gh-image",
+    ].join("\n"));
+}
+export function editPrBody(runner, pr, repo, body) {
+    const dir = mkdtempSync(join(tmpdir(), "gh-pr-attach-screenshots-"));
+    const bodyFile = join(dir, "body.md");
+    try {
+        writeFileSync(bodyFile, body);
+        gh(runner, ["pr", "edit", pr, "--repo", repo, "--body-file", bodyFile]);
+    }
+    finally {
+        rmSync(dir, { force: true, recursive: true });
+    }
+}
+//# sourceMappingURL=github-cli.mjs.map

package/dist/github-cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-cli.mjs","sourceRoot":"","sources":["../src/github-cli.mts"],"names":[],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+export { attachPrScreenshots, type AttachScreenshotOptions } from "./attach.mjs";
+export { HelpRequested, parseArgs } from "./parse-args.mjs";
+export { upsertScreenshotsSection } from "./screenshots-section.mjs";
+export { type CommandResult, type CommandRunner, runCommand } from "./github-cli.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export { attachPrScreenshots } from "./attach.mjs";
+export { HelpRequested, parseArgs } from "./parse-args.mjs";
+export { upsertScreenshotsSection } from "./screenshots-section.mjs";
+export { runCommand } from "./github-cli.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAgC,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAA0C,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/parse-args.d.mts

@@ -0,0 +1,11 @@
+export type AttachScreenshotOptions = {
+    images: string[];
+    pr?: string;
+    repo?: string;
+    replace: boolean;
+};
+export declare class HelpRequested extends Error {
+    constructor();
+}
+export declare function parseArgs(args: string[]): AttachScreenshotOptions;
+//# sourceMappingURL=parse-args.d.mts.map

package/dist/parse-args.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.mts","sourceRoot":"","sources":["../src/parse-args.mts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;;CAIvC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAiDjE"}

package/dist/parse-args.mjs

@@ -0,0 +1,70 @@
+export class HelpRequested extends Error {
+    constructor() {
+        super(usage());
+    }
+}
+export function parseArgs(args) {
+    const parsed = { images: [], replace: false };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--replace") {
+            parsed.replace = true;
+            continue;
+        }
+        if (arg === "--pr") {
+            parsed.pr = readOptionValue(args, index, "--pr");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--pr=")) {
+            parsed.pr = arg.slice("--pr=".length);
+            continue;
+        }
+        if (arg === "--repo") {
+            parsed.repo = readOptionValue(args, index, "--repo");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--repo=")) {
+            parsed.repo = arg.slice("--repo=".length);
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            throw new HelpRequested();
+        }
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown option "${arg}".\n\n${usage()}`);
+        }
+        parsed.images.push(arg);
+    }
+    if (parsed.images.length === 0) {
+        throw new Error(`At least one image path is required.\n\n${usage()}`);
+    }
+    return parsed;
+}
+function readOptionValue(args, index, option) {
+    const value = args[index + 1];
+    if (value === undefined || value.startsWith("-")) {
+        throw new Error(`${option} requires a value.`);
+    }
+    return value;
+}
+function usage() {
+    return [
+        "Usage: gh-pr-attach-screenshots [--pr <number|branch|url>] [--repo owner/repo] [--replace] <image...>",
+        "",
+        "Uploads screenshots with gh-image and attaches them to the PR description.",
+        "",
+        "Options:",
+        "  --pr <value>    PR number, branch name, or URL (defaults to current branch PR)",
+        "  --repo <value>  Repository in owner/repo format (defaults to current repo)",
+        "  --replace       Replace existing screenshots instead of merging",
+        "  --help, -h      Show this help message",
+        "",
+        "Prerequisites:",
+        "  - gh (GitHub CLI): brew install gh && gh auth login",
+        "  - gh-image extension: gh extension install drogers0/gh-image",
+        "    (may need to run outside any sandbox)",
+    ].join("\n");
+}
+//# sourceMappingURL=parse-args.mjs.map

package/dist/parse-args.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.mjs","sourceRoot":"","sources":["../src/parse-args.mts"],"names":[],"mappings":"AAOA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC;QACE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,MAAM,GAA4B,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAEvE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;QAEzB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACjD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACtC,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YACrD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,aAAa,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,SAAS,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,KAAa,EAAE,MAAc;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,oBAAoB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK;IACZ,OAAO;QACL,uGAAuG;QACvG,EAAE;QACF,4EAA4E;QAC5E,EAAE;QACF,UAAU;QACV,kFAAkF;QAClF,8EAA8E;QAC9E,mEAAmE;QACnE,0CAA0C;QAC1C,EAAE;QACF,gBAAgB;QAChB,uDAAuD;QACvD,gEAAgE;QAChE,2CAA2C;KAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/screenshots-section.d.mts

@@ -0,0 +1,4 @@
+export declare function upsertScreenshotsSection(body: string, imageMarkdown: string[], { replace }: {
+    replace: boolean;
+}): string;
+//# sourceMappingURL=screenshots-section.d.mts.map

package/dist/screenshots-section.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-section.d.mts","sourceRoot":"","sources":["../src/screenshots-section.mts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EAAE,EACvB,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CAeR"}

package/dist/screenshots-section.mjs

@@ -0,0 +1,43 @@
+const sectionStart = "<!-- agent-screenshots:start -->";
+const sectionEnd = "<!-- agent-screenshots:end -->";
+export function upsertScreenshotsSection(body, imageMarkdown, { replace }) {
+    const existingSection = findScreenshotsSection(body);
+    const existingImages = existingSection === null || replace ? [] : screenshotLines(existingSection.content);
+    const nextImages = dedupe([
+        ...existingImages,
+        ...imageMarkdown.map((line) => line.trim()).filter(Boolean),
+    ]);
+    const nextSection = renderScreenshotsSection(nextImages);
+    if (existingSection === null) {
+        return `${body.trimEnd()}\n\n${nextSection}\n`;
+    }
+    return `${body.slice(0, existingSection.start)}${nextSection}${body.slice(existingSection.end)}`;
+}
+function findScreenshotsSection(body) {
+    const startMarker = body.indexOf(sectionStart);
+    const endMarker = body.indexOf(sectionEnd, startMarker + sectionStart.length);
+    if (startMarker === -1 || endMarker === -1) {
+        return null;
+    }
+    const headingStart = body.lastIndexOf("## Screenshots", startMarker);
+    const start = headingStart === -1 ? startMarker : headingStart;
+    const end = endMarker + sectionEnd.length;
+    return {
+        content: body.slice(startMarker + sectionStart.length, endMarker),
+        end,
+        start,
+    };
+}
+function screenshotLines(content) {
+    return content
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith("![") && line.includes("](http"));
+}
+function dedupe(values) {
+    return [...new Set(values)];
+}
+function renderScreenshotsSection(imageMarkdown) {
+    return ["## Screenshots", sectionStart, ...imageMarkdown, sectionEnd].join("\n");
+}
+//# sourceMappingURL=screenshots-section.mjs.map

package/dist/screenshots-section.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-section.mjs","sourceRoot":"","sources":["../src/screenshots-section.mts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,kCAAkC,CAAC;AACxD,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAEpD,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,aAAuB,EACvB,EAAE,OAAO,EAAwB;IAEjC,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,cAAc,GAClB,eAAe,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,MAAM,CAAC;QACxB,GAAG,cAAc;QACjB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;KAC5D,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAEzD,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,WAAW,IAAI,CAAC;IACjD,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAY;IAEZ,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;IAC/D,MAAM,GAAG,GAAG,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IAC1C,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QACjE,GAAG;QACH,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,wBAAwB,CAAC,aAAuB;IACvD,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC"}

package/dist/src/attach.d.mts

@@ -0,0 +1,5 @@
+import { type CommandRunner } from './github-cli.mts';
+import { type AttachScreenshotOptions } from './parse-args.mts';
+export type { AttachScreenshotOptions };
+export declare function attachPrScreenshots(options: AttachScreenshotOptions, runner?: CommandRunner): string;
+//# sourceMappingURL=attach.d.mts.map

package/dist/src/attach.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.mts","sourceRoot":"","sources":["../../src/attach.mts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAMnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAG/D,YAAY,EAAE,uBAAuB,EAAE,CAAA;AAEvC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,EAChC,MAAM,GAAE,aAA0B,GACjC,MAAM,CAyBR"}

package/dist/src/attach.mjs

@@ -0,0 +1,23 @@
+import { existsSync } from 'node:fs';
+import { editPrBody, ensureGhImageExtension, gh, runCommand, validateGh, } from './github-cli.mts';
+import { upsertScreenshotsSection } from './screenshots-section.mts';
+export function attachPrScreenshots(options, runner = runCommand) {
+    validateGh(runner);
+    ensureGhImageExtension(runner);
+    const repo = options.repo ??
+        gh(runner, ['repo', 'view', '--json', 'nameWithOwner', '--jq', '.nameWithOwner']);
+    const pr = options.pr ??
+        gh(runner, ['pr', 'view', '--repo', repo, '--json', 'number', '--jq', '.number']);
+    const imageMarkdown = options.images.map(image => {
+        if (!existsSync(image)) {
+            throw new Error(`Screenshot not found: ${image}`);
+        }
+        return gh(runner, ['image', image, '--repo', repo]);
+    });
+    const body = gh(runner, ['pr', 'view', pr, '--repo', repo, '--json', 'body', '--jq', '.body']);
+    const nextBody = upsertScreenshotsSection(body, imageMarkdown, { replace: options.replace });
+    editPrBody(runner, pr, repo, nextBody);
+    process.stderr.write(`Attached ${imageMarkdown.length} screenshot(s) to PR #${pr} in ${repo}\n`);
+    return nextBody;
+}
+//# sourceMappingURL=attach.mjs.map

package/dist/src/attach.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.mjs","sourceRoot":"","sources":["../../src/attach.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAEL,UAAU,EACV,sBAAsB,EACtB,EAAE,EACF,UAAU,EACV,UAAU,GACX,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAIpE,MAAM,UAAU,mBAAmB,CACjC,OAAgC,EAChC,SAAwB,UAAU;IAElC,UAAU,CAAC,MAAM,CAAC,CAAA;IAClB,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAE9B,MAAM,IAAI,GACR,OAAO,CAAC,IAAI;QACZ,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;IACnF,MAAM,EAAE,GACN,OAAO,CAAC,EAAE;QACV,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IAEnF,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC/C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAA;QACnD,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9F,MAAM,QAAQ,GAAG,wBAAwB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC5F,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,aAAa,CAAC,MAAM,yBAAyB,EAAE,OAAO,IAAI,IAAI,CAAC,CAAA;IAEhG,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/src/cli.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(args: string[]): void;
+//# sourceMappingURL=cli.d.mts.map

package/dist/src/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","sourceRoot":"","sources":["../../src/cli.mts"],"names":[],"mappings":";AAIA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAWzC"}

package/dist/src/cli.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { attachPrScreenshots } from './attach.mts';
+import { HelpRequested, parseArgs } from './parse-args.mts';
+export function main(args) {
+    try {
+        attachPrScreenshots(parseArgs(args));
+    }
+    catch (error) {
+        if (error instanceof HelpRequested) {
+            console.log(error.message);
+            process.exit(0);
+        }
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(2);
+    }
+}
+if (process.argv[1] === import.meta.filename) {
+    main(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.mjs.map

package/dist/src/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sourceRoot":"","sources":["../../src/cli.mts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE3D,MAAM,UAAU,IAAI,CAAC,IAAc;IACjC,IAAI,CAAC;QACH,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7B,CAAC"}

package/dist/src/github-cli.d.mts

@@ -0,0 +1,14 @@
+export type CommandResult = {
+    error?: Error;
+    status: number | null;
+    stderr: string;
+    stdout: string;
+};
+export type CommandRunner = (command: string, args: string[]) => CommandResult;
+export declare function runCommand(command: string, args: string[]): CommandResult;
+export declare function formatCommandError(command: string, result: CommandResult): string;
+export declare function gh(runner: CommandRunner, args: string[]): string;
+export declare function validateGh(runner: CommandRunner): void;
+export declare function ensureGhImageExtension(runner: CommandRunner): void;
+export declare function editPrBody(runner: CommandRunner, pr: string, repo: string, body: string): void;
+//# sourceMappingURL=github-cli.d.mts.map

package/dist/src/github-cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-cli.d.mts","sourceRoot":"","sources":["../../src/github-cli.mts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,CAAA;AAE9E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAYzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAGjF;AAED,wBAAgB,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAMhE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAiBtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAmBlE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAS9F"}

package/dist/src/github-cli.mjs

@@ -0,0 +1,75 @@
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const extensionName = 'drogers0/gh-image';
+export function runCommand(command, args) {
+    const options = {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    };
+    const result = spawnSync(command, args, options);
+    return {
+        error: result.error,
+        status: result.status,
+        stderr: result.stderr ?? '',
+        stdout: result.stdout ?? '',
+    };
+}
+export function formatCommandError(command, result) {
+    const detail = (result.error?.message ?? result.stderr.trim()) || result.stdout.trim();
+    return detail ? `${command} failed: ${detail}` : `${command} failed.`;
+}
+export function gh(runner, args) {
+    const result = runner('gh', args);
+    if (result.status !== 0) {
+        throw new Error(formatCommandError(`gh ${args.join(' ')}`, result));
+    }
+    return result.stdout.trim();
+}
+export function validateGh(runner) {
+    const result = runner('gh', ['--version']);
+    if (result.error !== undefined || result.status !== 0) {
+        throw new Error([
+            '`gh` (GitHub CLI) is not installed or not on PATH.',
+            '',
+            'Install it:',
+            '  macOS:   brew install gh',
+            '  Linux:   https://github.com/cli/cli#installation',
+            '  Windows: winget install --id GitHub.cli',
+            '',
+            'Then authenticate:',
+            '  gh auth login',
+        ].join('\n'));
+    }
+}
+export function ensureGhImageExtension(runner) {
+    const result = runner('gh', ['extension', 'list']);
+    if (result.status !== 0) {
+        throw new Error(formatCommandError('gh extension list', result));
+    }
+    if (result.stdout.includes(extensionName) || /^gh-image\b/m.test(result.stdout)) {
+        return;
+    }
+    throw new Error([
+        'The `gh-image` extension is not installed.',
+        '',
+        'Install it (this may need to run outside any sandbox, as the extension',
+        'stores credentials under ~/.config/gh):',
+        '  gh extension install drogers0/gh-image',
+        '',
+        'Project: https://github.com/drogers0/gh-image',
+    ].join('\n'));
+}
+export function editPrBody(runner, pr, repo, body) {
+    const dir = mkdtempSync(join(tmpdir(), 'gh-pr-attach-screenshots-'));
+    const bodyFile = join(dir, 'body.md');
+    try {
+        writeFileSync(bodyFile, body);
+        gh(runner, ['pr', 'edit', pr, '--repo', repo, '--body-file', bodyFile]);
+    }
+    finally {
+        rmSync(dir, { force: true, recursive: true });
+    }
+}
+//# sourceMappingURL=github-cli.mjs.map

package/dist/src/github-cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-cli.mjs","sourceRoot":"","sources":["../../src/github-cli.mts"],"names":[],"mappings":"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"}

package/dist/src/index.d.mts

@@ -0,0 +1,5 @@
+export { attachPrScreenshots, type AttachScreenshotOptions } from './attach.mts';
+export { HelpRequested, parseArgs } from './parse-args.mts';
+export { upsertScreenshotsSection } from './screenshots-section.mts';
+export { type CommandResult, type CommandRunner, runCommand } from './github-cli.mts';
+//# sourceMappingURL=index.d.mts.map

package/dist/src/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/index.mjs

@@ -0,0 +1,5 @@
+export { attachPrScreenshots } from './attach.mts';
+export { HelpRequested, parseArgs } from './parse-args.mts';
+export { upsertScreenshotsSection } from './screenshots-section.mts';
+export { runCommand } from './github-cli.mts';
+//# sourceMappingURL=index.mjs.map

package/dist/src/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAgC,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAA0C,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/parse-args.d.mts

@@ -0,0 +1,11 @@
+export type AttachScreenshotOptions = {
+    images: string[];
+    pr?: string;
+    repo?: string;
+    replace: boolean;
+};
+export declare class HelpRequested extends Error {
+    constructor();
+}
+export declare function parseArgs(args: string[]): AttachScreenshotOptions;
+//# sourceMappingURL=parse-args.d.mts.map

package/dist/src/parse-args.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.mts","sourceRoot":"","sources":["../../src/parse-args.mts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,qBAAa,aAAc,SAAQ,KAAK;;CAIvC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAiDjE"}

package/dist/src/parse-args.mjs

@@ -0,0 +1,70 @@
+export class HelpRequested extends Error {
+    constructor() {
+        super(usage());
+    }
+}
+export function parseArgs(args) {
+    const parsed = { images: [], replace: false };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--replace') {
+            parsed.replace = true;
+            continue;
+        }
+        if (arg === '--pr') {
+            parsed.pr = readOptionValue(args, index, '--pr');
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--pr=')) {
+            parsed.pr = arg.slice('--pr='.length);
+            continue;
+        }
+        if (arg === '--repo') {
+            parsed.repo = readOptionValue(args, index, '--repo');
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--repo=')) {
+            parsed.repo = arg.slice('--repo='.length);
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            throw new HelpRequested();
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option "${arg}".\n\n${usage()}`);
+        }
+        parsed.images.push(arg);
+    }
+    if (parsed.images.length === 0) {
+        throw new Error(`At least one image path is required.\n\n${usage()}`);
+    }
+    return parsed;
+}
+function readOptionValue(args, index, option) {
+    const value = args[index + 1];
+    if (value === undefined || value.startsWith('-')) {
+        throw new Error(`${option} requires a value.`);
+    }
+    return value;
+}
+function usage() {
+    return [
+        'Usage: gh-pr-attach-screenshots [--pr <number|branch|url>] [--repo owner/repo] [--replace] <image...>',
+        '',
+        'Uploads screenshots with gh-image and attaches them to the PR description.',
+        '',
+        'Options:',
+        '  --pr <value>    PR number, branch name, or URL (defaults to current branch PR)',
+        '  --repo <value>  Repository in owner/repo format (defaults to current repo)',
+        '  --replace       Replace existing screenshots instead of merging',
+        '  --help, -h      Show this help message',
+        '',
+        'Prerequisites:',
+        '  - gh (GitHub CLI): brew install gh && gh auth login',
+        '  - gh-image extension: gh extension install drogers0/gh-image',
+        '    (may need to run outside any sandbox)',
+    ].join('\n');
+}
+//# sourceMappingURL=parse-args.mjs.map

package/dist/src/parse-args.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.mjs","sourceRoot":"","sources":["../../src/parse-args.mts"],"names":[],"mappings":"AAOA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC;QACE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;IAChB,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,MAAM,GAA4B,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IAEtE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAE,CAAA;QAExB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;YACrB,SAAQ;QACV,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;YAChD,KAAK,IAAI,CAAC,CAAA;YACV,SAAQ;QACV,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACrC,SAAQ;QACV,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;YACpD,KAAK,IAAI,CAAC,CAAA;YACV,SAAQ;QACV,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,aAAa,EAAE,CAAA;QAC3B,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,SAAS,KAAK,EAAE,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,EAAE,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,KAAa,EAAE,MAAc;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,oBAAoB,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,KAAK;IACZ,OAAO;QACL,uGAAuG;QACvG,EAAE;QACF,4EAA4E;QAC5E,EAAE;QACF,UAAU;QACV,kFAAkF;QAClF,8EAA8E;QAC9E,mEAAmE;QACnE,0CAA0C;QAC1C,EAAE;QACF,gBAAgB;QAChB,uDAAuD;QACvD,gEAAgE;QAChE,2CAA2C;KAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/src/screenshots-section.d.mts

@@ -0,0 +1,4 @@
+export declare function upsertScreenshotsSection(body: string, imageMarkdown: string[], { replace }: {
+    replace: boolean;
+}): string;
+//# sourceMappingURL=screenshots-section.d.mts.map

package/dist/src/screenshots-section.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-section.d.mts","sourceRoot":"","sources":["../../src/screenshots-section.mts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EAAE,EACvB,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CAeR"}

package/dist/src/screenshots-section.mjs

@@ -0,0 +1,43 @@
+const sectionStart = '<!-- agent-screenshots:start -->';
+const sectionEnd = '<!-- agent-screenshots:end -->';
+export function upsertScreenshotsSection(body, imageMarkdown, { replace }) {
+    const existingSection = findScreenshotsSection(body);
+    const existingImages = existingSection === null || replace ? [] : screenshotLines(existingSection.content);
+    const nextImages = dedupe([
+        ...existingImages,
+        ...imageMarkdown.map(line => line.trim()).filter(Boolean),
+    ]);
+    const nextSection = renderScreenshotsSection(nextImages);
+    if (existingSection === null) {
+        return `${body.trimEnd()}\n\n${nextSection}\n`;
+    }
+    return `${body.slice(0, existingSection.start)}${nextSection}${body.slice(existingSection.end)}`;
+}
+function findScreenshotsSection(body) {
+    const startMarker = body.indexOf(sectionStart);
+    const endMarker = body.indexOf(sectionEnd, startMarker + sectionStart.length);
+    if (startMarker === -1 || endMarker === -1) {
+        return null;
+    }
+    const headingStart = body.lastIndexOf('## Screenshots', startMarker);
+    const start = headingStart === -1 ? startMarker : headingStart;
+    const end = endMarker + sectionEnd.length;
+    return {
+        content: body.slice(startMarker + sectionStart.length, endMarker),
+        end,
+        start,
+    };
+}
+function screenshotLines(content) {
+    return content
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line.startsWith('![') && line.includes('](http'));
+}
+function dedupe(values) {
+    return [...new Set(values)];
+}
+function renderScreenshotsSection(imageMarkdown) {
+    return ['## Screenshots', sectionStart, ...imageMarkdown, sectionEnd].join('\n');
+}
+//# sourceMappingURL=screenshots-section.mjs.map

package/dist/src/screenshots-section.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-section.mjs","sourceRoot":"","sources":["../../src/screenshots-section.mts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,kCAAkC,CAAA;AACvD,MAAM,UAAU,GAAG,gCAAgC,CAAA;AAEnD,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,aAAuB,EACvB,EAAE,OAAO,EAAwB;IAEjC,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;IACpD,MAAM,cAAc,GAClB,eAAe,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACrF,MAAM,UAAU,GAAG,MAAM,CAAC;QACxB,GAAG,cAAc;QACjB,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;KAC1D,CAAC,CAAA;IACF,MAAM,WAAW,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAExD,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,WAAW,IAAI,CAAA;IAChD,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAA;AAClG,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAY;IAEZ,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IAC7E,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAA;IACpE,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAA;IAC9D,MAAM,GAAG,GAAG,SAAS,GAAG,UAAU,CAAC,MAAM,CAAA;IACzC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QACjE,GAAG;QACH,KAAK;KACN,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;AACrE,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAC7B,CAAC;AAED,SAAS,wBAAwB,CAAC,aAAuB;IACvD,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAClF,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "gh-pr-attach-screenshots",
+  "version": "0.1.0",
+  "description": "Upload screenshots with gh-image and attach them to a GitHub PR description",
+  "keywords": [
+    "agent",
+    "cli",
+    "gh",
+    "github",
+    "pr",
+    "pull-request",
+    "screenshot"
+  ],
+  "homepage": "https://github.com/jonathanong/gh-pr-attach-screenshots",
+  "bugs": {
+    "url": "https://github.com/jonathanong/gh-pr-attach-screenshots/issues"
+  },
+  "license": "MIT",
+  "author": "Jonathan Ong <jonathanrichardong@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jonathanong/gh-pr-attach-screenshots.git"
+  },
+  "bin": {
+    "gh-pr-attach-screenshots": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "oxfmt": "^0.50.0",
+    "oxlint": "^1.65.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json && chmod +x dist/cli.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint --deny-warnings .",
+    "lint:fix": "oxlint --deny-warnings --fix .",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check ."
+  }
+}

package/skills/gh-pr-attach-screenshots/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: gh-pr-attach-screenshots
+description: Use this skill when the user asks to attach a screenshot to a GitHub PR, dog-food a UI change visually, or upload a local image into a pull request's description. Invokes the `gh-pr-attach-screenshots` CLI, which uploads images via `gh-image` and manages a `## Screenshots` section in the PR body.
+---
+
+## What it does
+
+`gh-pr-attach-screenshots` uploads local image files via the [`drogers0/gh-image`](https://github.com/drogers0/gh-image) `gh` extension and upserts a delimited `## Screenshots` section in the PR description. Running it multiple times merges images without duplicates. `--replace` swaps the managed block entirely.
+
+## When to use it
+
+- User asks to "attach a screenshot to the PR" or "post this image on my PR"
+- User shares a local image path and references an open PR
+- After a visual UI change, to show before/after on the PR
+- You (the agent) took a browser screenshot of a rendered page and want to surface it in the PR
+
+## How to invoke
+
+Run without installing (recommended for agents):
+
+| Package manager | Command                                              |
+| --------------- | ---------------------------------------------------- |
+| npm             | `npx gh-pr-attach-screenshots ./screenshot.png`      |
+| pnpm            | `pnpm dlx gh-pr-attach-screenshots ./screenshot.png` |
+| yarn            | `yarn dlx gh-pr-attach-screenshots ./screenshot.png` |
+| bun             | `bunx gh-pr-attach-screenshots ./screenshot.png`     |
+
+Common variants:
+
+```sh
+# Attach multiple images
+npx gh-pr-attach-screenshots ./desktop.png ./mobile.png
+
+# Target a specific PR (accepts number, branch name, or URL)
+npx gh-pr-attach-screenshots --pr 123 ./screenshot.png
+
+# Replace the existing screenshots block instead of merging
+npx gh-pr-attach-screenshots --replace ./new.png
+
+# Explicit repo
+npx gh-pr-attach-screenshots --repo owner/repo ./screenshot.png
+```
+
+`--pr` defaults to the current branch's PR. `--repo` defaults to the current repo.
+
+## Prerequisites & fail-fast recovery
+
+The tool exits non-zero immediately if prerequisites are missing and prints actionable instructions to stderr. Surface stderr verbatim to the user.
+
+**`gh` not installed:**
+
+```
+brew install gh    # macOS
+gh auth login
+```
+
+See [cli.github.com](https://cli.github.com) for Linux/Windows install options.
+
+**`gh-image` extension not installed:**
+
+```sh
+gh extension install drogers0/gh-image
+```
+
+> Run this command **outside any sandbox** — the extension stores credentials under `~/.config/gh` and may read browser session tokens.
+
+**Image file not found:** the tool prints `Screenshot not found: <path>`. Check the path and retry.
+
+## Success signal
+
+On success the CLI prints to stderr and exits `0`:
+
+```
+Attached N screenshot(s) to PR #<number> in <owner>/<repo>
+```
+
+Consider the task complete when you see that line.
+
+## Browser screenshot recipe
+
+When you need to produce the image first:
+
+1. Use the available browser MCP tool to navigate to the page and take a screenshot:
+   - `mcp__claude-in-chrome__browser_take_screenshot`
+   - `mcp__plugin_playwright_playwright__browser_take_screenshot`
+2. Save to a temp file (e.g., /tmp/screenshot.png)
+3. Run the CLI with that path.
+4. Delete the temp file when done.