From febeb679bd34e83edf05c6ffa60d528cbeb148a3 Mon Sep 17 00:00:00 2001
From: Corvid Agent <0xopenbytes@gmail.com>
Date: Thu, 21 May 2026 15:59:01 -0700
Subject: [PATCH] feat(v0.6.0): write ops + diff/comments view flags + repo
 file reader
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Make the plugin genuinely useful for agents driving real GitHub work,
not just read-only summaries. Closes the gap where Merlin agents kept
falling back to authenticated-failing `web-fetch` calls because the
plugin couldn't surface diffs, comments, or file contents at a ref.

prs:
  - `view` gets --diff and --comments append flags.
  - `comment <num> -b BODY` posts a PR comment.
  - `review <num> --approve | --request-changes | --comment-review`
    submits a review (--body required for the latter two).
  - `merge <num>` with --squash (default) | --merge | --rebase.
  - `close <num>` and `reopen <num>`.

issues:
  - `view` gets a --comments flag.
  - `comment <num> -b BODY`, `close <num>`, `reopen <num>`.

repo (new subcommand):
  - `view [-R OWNER/NAME] [--json]` — repo metadata.
  - `file <path> [-R OWNER/NAME] [-r REF] [--json]` — read a file's
    contents at any ref. Wraps `gh api repos/.../contents/...` and
    decodes the base64, so it works for private repos and arbitrary
    refs without needing a clone or a raw-URL token.

Router and plugin.toml description updated; README + CHANGELOG follow.
Bash strict-mode safe (empty-array expansion uses scalars), shellcheck
clean at --severity=warning.
---
 CHANGELOG.md             |  16 ++++
 README.md                |  51 ++++++++----
 bin/fledge-github        |   7 +-
 bin/fledge-github-issues |  78 ++++++++++++++----
 bin/fledge-github-prs    | 166 +++++++++++++++++++++++++++++++++------
 bin/fledge-github-repo   | 128 ++++++++++++++++++++++++++++++
 plugin.toml              |   8 +-
 7 files changed, 392 insertions(+), 62 deletions(-)
 create mode 100755 bin/fledge-github-repo

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c844281..ef124ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # Changelog
 
+## [v0.6.0] - 2026-05-21
+
+### Features
+
+- `prs view`: add `--diff` and `--comments` flags to append the unified diff and conversation comments + reviews to the view output.
+- `prs comment <NUMBER> -b BODY`: post a comment on a pull request.
+- `prs review <NUMBER>`: submit a review — one of `--approve`, `--request-changes`, or `--comment-review`, plus `--body`.
+- `prs merge <NUMBER>`: merge a PR with `--squash` (default), `--merge`, or `--rebase`.
+- `prs close <NUMBER>` / `prs reopen <NUMBER>`: close without merging or reopen.
+- `issues view`: add `--comments` flag to append the issue conversation.
+- `issues comment <NUMBER> -b BODY`: post a comment on an issue.
+- `issues close <NUMBER>` / `issues reopen <NUMBER>`.
+- New `repo` subcommand:
+  - `repo view [-R OWNER/NAME] [--json]` — repo metadata.
+  - `repo file <PATH> [-R OWNER/NAME] [-r REF] [--json]` — read a file's contents at any ref via `gh api repos/.../contents/...`. Closes the gap where agents fell back to authenticated-failing `web-fetch` against `raw.githubusercontent.com`.
+
 ## [v0.5.0] - 2026-05-13
 
 ### Features
diff --git a/README.md b/README.md
index 18228f8..1ea8fb8 100644
--- a/README.md
+++ b/README.md
@@ -37,38 +37,61 @@ $ fledge github checks
 
 JSON output is the raw GitHub API response from `repos/{owner}/{repo}/commits/{branch}/check-runs`.
 
-### `fledge github issues [list | view <num> | create] [OPTIONS]`
+### `fledge github issues [list | view <num> | create | comment <num> | close <num> | reopen <num>] [OPTIONS]`
 
-Browse and create issues. Lists by default; `view <number>` shows a specific one; `create` opens a new issue.
+Browse, create, and write to issues. Lists by default.
 
 ```
 $ fledge github issues --state all --limit 5
-$ fledge github issues view 42 --json
+$ fledge github issues view 42 --comments
 $ fledge github issues create --title "Bug: something broke"
-$ fledge github issues create --title "Feature request" --label enhancement --assignee octocat --json
+$ fledge github issues comment 42 -b "Reproduced on 0.3.1."
+$ fledge github issues close 42
+$ fledge github issues reopen 42
 ```
 
-List/view options: `--state {open,closed,all}`, `--limit <N>`, `--label <label>`, `--json`.  
-Create options: `--title <title>`, `--body <body>`, `--label <label>`, `--assignee <login>`, `--json`.
+List/view options: `--state {open,closed,all}`, `--limit <N>`, `--label <label>`, `--json`, `--comments` (view).  
+Create options: `--title <title>`, `--body <body>`, `--label <label>`, `--assignee <login>`, `--json`.  
+Comment options: `--body <body>` (required), `--json`.
 
-### `fledge github prs [list | view <num> | create] [OPTIONS]`
+### `fledge github prs [list | view <num> | create | comment <num> | review <num> | merge <num> | close <num> | reopen <num>] [OPTIONS]`
 
-Browse and create pull requests. Lists by default; `view <number>` shows a specific one; `create` opens a new PR.
+The full PR surface. Lists by default; everything else takes a PR number.
 
 ```
 $ fledge github prs --state merged --limit 5
-$ fledge github prs view 256 --json
+$ fledge github prs view 256 --diff --comments
 $ fledge github prs create --fill
-$ fledge github prs create --ai
 $ fledge github prs create --ai --draft
-$ fledge github prs create --title "My feature" --draft --json
+$ fledge github prs comment 256 -b "Looks good — one nit inline."
+$ fledge github prs review 256 --approve
+$ fledge github prs review 256 --request-changes -b "See comments."
+$ fledge github prs merge 256 --squash
+$ fledge github prs close 256
 ```
 
-List/view options: `--state {open,closed,merged,all}`, `--limit <N>`, `--json`.  
-Create options: `--title <title>`, `--body <body>`, `--base <branch>`, `--draft`, `--fill`, `--ai`, `--json`.
+List/view options: `--state {open,closed,merged,all}`, `--limit <N>`, `--json`, `--diff` (view, append unified diff), `--comments` (view, append conversation).  
+Create options: `--title <title>`, `--body <body>`, `--base <branch>`, `--draft`, `--fill`, `--ai`, `--json`.  
+Comment options: `--body <body>` (required), `--json`.  
+Review options: one of `--approve` / `--request-changes` / `--comment-review`, plus `--body <body>` (required for the latter two).  
+Merge options: `--squash` (default) | `--merge` | `--rebase`.
 
 `--ai` generates a PR title and body by sending your commits and diff to `fledge ask`. It shows a preview and lets you confirm, edit, or abort before creating the PR.
 
+### `fledge github repo [view | file <path>] [OPTIONS]`
+
+Read repo metadata or fetch a file's contents at a ref. `file` wraps `gh api repos/.../contents/...` and decodes the base64, so it works for any branch/tag/SHA without needing a clone or a raw-URL token.
+
+```
+$ fledge github repo view
+$ fledge github repo view -R CorvidLabs/merlin --json
+$ fledge github repo file CHANGELOG.md
+$ fledge github repo file Cargo.toml -r v0.3.0
+$ fledge github repo file README.md -R CorvidLabs/fledge-plugin-github
+```
+
+Options: `-R, --repo <owner/name>` (default: current repo), `-r, --ref <ref>` (file only), `--json`.
+
 ### `fledge github poll [OPTIONS]`
 
 Poll for new issues and PRs as structured event objects. Designed for [Merlin](https://github.com/CorvidLabs/merlin) daemon mode — the output matches the daemon `Event` schema.
@@ -89,7 +112,7 @@ A flat `checks`/`issues`/`prs` surface bakes "all dev happens on GitHub" into fl
 
 ## Hacking
 
-`bin/fledge-github` is a thin dispatcher; each subcommand is a self-contained POSIX-ish shell script (`bin/fledge-github-checks`, `…-issues`, `…-prs`, `…-poll`). The scripts use `gh api` (or `gh issue`/`gh pr`) to talk to GitHub, then format the response — no extra runtime dependencies beyond `gh`, `git`, `python3`, and `awk`.
+`bin/fledge-github` is a thin dispatcher; each subcommand is a self-contained POSIX-ish shell script (`bin/fledge-github-checks`, `…-issues`, `…-prs`, `…-poll`, `…-repo`). The scripts use `gh api` (or `gh issue`/`gh pr`/`gh repo`) to talk to GitHub, then format the response — no extra runtime dependencies beyond `gh`, `git`, `python3`, `awk`, and `base64`.
 
 ## License
 
diff --git a/bin/fledge-github b/bin/fledge-github
index 45178ef..2c64bc8 100755
--- a/bin/fledge-github
+++ b/bin/fledge-github
@@ -24,8 +24,9 @@ USAGE:
 
 SUBCOMMANDS:
   checks    View CI/CD check status for a branch
-  issues    List and view GitHub issues
-  prs       List and view GitHub pull requests
+  issues    List, view, create, comment on, close, and reopen GitHub issues
+  prs       List, view, create, comment on, review, merge, close, and reopen pull requests
+  repo      View repo metadata and read file contents at a ref
   poll      Poll for new issues/PRs as daemon events (JSON)
 
 Run `fledge github <SUBCOMMAND> --help` for subcommand-specific options.
@@ -41,7 +42,7 @@ SUB="$1"
 shift
 
 case "$SUB" in
-  checks|issues|prs|poll)
+  checks|issues|prs|poll|repo)
     exec "${DIR}/fledge-github-${SUB}" "$@"
     ;;
   -h|--help|help)
diff --git a/bin/fledge-github-issues b/bin/fledge-github-issues
index f2685e1..a0eba1d 100755
--- a/bin/fledge-github-issues
+++ b/bin/fledge-github-issues
@@ -1,6 +1,8 @@
 #!/usr/bin/env bash
-# fledge-github-issues — list, view, and create GitHub issues via the gh CLI.
-# Invoked via: fledge github issues [create | view <num> | list] [OPTIONS]
+# fledge-github-issues — list, view, create, comment on, close, and reopen
+# GitHub issues via the gh CLI.
+# Invoked via: fledge github issues [list | view <num> | create | comment <num> |
+#   close <num> | reopen <num>] [OPTIONS]
 set -euo pipefail
 
 ACTION="list"
@@ -12,12 +14,13 @@ TITLE=""
 BODY=""
 ASSIGNEE=""
 JSON=false
+INCLUDE_COMMENTS=false
 
-# First positional arg can be a subcommand: create, view, or list
+# First positional arg can be a subcommand.
 if [ $# -gt 0 ] && [ "${1:0:1}" != "-" ]; then
   case "$1" in
-    view)
-      ACTION="view"
+    view|comment|close|reopen)
+      ACTION="$1"
       shift
       if [ $# -gt 0 ] && [ "${1:0:1}" != "-" ]; then
         NUMBER="$1"
@@ -44,34 +47,44 @@ while [ $# -gt 0 ]; do
     -b|--body)       BODY="${2:-}"; shift 2;;
     -a|--assignee)   ASSIGNEE="${2:-}"; shift 2;;
     --json)          JSON=true; shift;;
+    --comments)      INCLUDE_COMMENTS=true; shift;;
     -h|--help)
       cat <<'EOF'
-fledge github issues — list, view, and create GitHub issues
+fledge github issues — manage GitHub issues via the gh CLI
 
 USAGE:
-  fledge github issues [list]                List open issues (default)
-  fledge github issues view <NUMBER>         View a specific issue
-  fledge github issues create                Create a new issue
+  fledge github issues [list]                       List open issues (default)
+  fledge github issues view <NUMBER>                View a specific issue
+  fledge github issues create                       Create a new issue
+  fledge github issues comment <NUMBER> -b BODY     Post a comment
+  fledge github issues close <NUMBER>               Close an issue
+  fledge github issues reopen <NUMBER>              Reopen a closed issue
 
 LIST / VIEW OPTIONS:
   -s, --state <STATE>   open | closed | all  (default: open)
   -l, --limit <N>       Maximum results (default: 20)
       --label <LABEL>   Filter by label
       --json            Output JSON
+      --comments        (view) Append the issue's conversation comments
 
 CREATE OPTIONS:
   -t, --title <TITLE>      Issue title
   -b, --body <BODY>        Issue body
-      --label <LABEL>      Attach label (repeatable)
+      --label <LABEL>      Attach label (repeatable on the gh side)
   -a, --assignee <LOGIN>   Assign to user
       --json               Output JSON (number, url, title)
 
+COMMENT OPTIONS:
+  -b, --body <BODY>     Comment body (required)
+      --json            Output JSON (url)
+
 EXAMPLES:
   fledge github issues
   fledge github issues --state all --limit 50
-  fledge github issues view 42 --json
+  fledge github issues view 42 --comments
   fledge github issues create --title "Bug: something broke"
-  fledge github issues create --title "Feature request" --label enhancement --assignee octocat
+  fledge github issues comment 42 -b "Reproduced on 0.3.1 too."
+  fledge github issues close 42
 EOF
       exit 0
       ;;
@@ -87,16 +100,49 @@ if ! command -v gh >/dev/null 2>&1; then
   exit 127
 fi
 
+case "$ACTION" in
+  view|comment|close|reopen)
+    if [ -z "$NUMBER" ]; then
+      echo "fledge github issues: '$ACTION' requires an issue number. Try: fledge github issues $ACTION 42" >&2
+      exit 64
+    fi
+    ;;
+esac
+
 if [ "$ACTION" = "view" ]; then
-  if [ -z "$NUMBER" ]; then
-    echo "fledge github issues: 'view' requires an issue number. Try: fledge github issues view 42" >&2
-    exit 64
-  fi
   if [ "$JSON" = "true" ]; then
     gh issue view "$NUMBER" --json number,title,state,author,body,labels,createdAt,updatedAt,url,assignees
   else
     gh issue view "$NUMBER"
   fi
+  if [ "$JSON" != "true" ] && [ "$INCLUDE_COMMENTS" = "true" ]; then
+    printf '\n--- Comments ---\n'
+    gh issue view "$NUMBER" --comments
+  fi
+  exit 0
+fi
+
+if [ "$ACTION" = "comment" ]; then
+  if [ -z "$BODY" ]; then
+    echo "fledge github issues: 'comment' requires --body" >&2
+    exit 64
+  fi
+  if [ "$JSON" = "true" ]; then
+    URL="$(gh issue comment "$NUMBER" -b "$BODY")"
+    printf '{"url":"%s"}\n' "$URL"
+  else
+    gh issue comment "$NUMBER" -b "$BODY"
+  fi
+  exit 0
+fi
+
+if [ "$ACTION" = "close" ]; then
+  gh issue close "$NUMBER"
+  exit 0
+fi
+
+if [ "$ACTION" = "reopen" ]; then
+  gh issue reopen "$NUMBER"
   exit 0
 fi
 
diff --git a/bin/fledge-github-prs b/bin/fledge-github-prs
index 9d8512c..5e0c40b 100755
--- a/bin/fledge-github-prs
+++ b/bin/fledge-github-prs
@@ -1,6 +1,8 @@
 #!/usr/bin/env bash
-# fledge-github-prs — list, view, and create GitHub pull requests via the gh CLI.
-# Invoked via: fledge github prs [create | view <num> | list] [OPTIONS]
+# fledge-github-prs — list, view, create, comment on, review, merge, close,
+# and reopen GitHub pull requests via the gh CLI.
+# Invoked via: fledge github prs [list | view <num> | create | comment <num> |
+#   review <num> | merge <num> | close <num> | reopen <num>] [OPTIONS]
 set -euo pipefail
 
 ACTION="list"
@@ -14,6 +16,10 @@ DRAFT=false
 FILL=false
 JSON=false
 AI=false
+INCLUDE_DIFF=false
+INCLUDE_COMMENTS=false
+MERGE_METHOD="squash"
+REVIEW_KIND=""
 
 # ANSI color codes
 BLUE=$'\033[0;34m'
@@ -21,10 +27,12 @@ BOLD=$'\033[1m'
 YELLOW=$'\033[0;33m'
 RESET=$'\033[0m'
 
+# Parse positional subcommand. `view`, `comment`, `review`, `merge`, `close`,
+# and `reopen` all take a number; `create` and `list` don't.
 if [ $# -gt 0 ] && [ "${1:0:1}" != "-" ]; then
   case "$1" in
-    view)
-      ACTION="view"
+    view|comment|review|merge|close|reopen)
+      ACTION="$1"
       shift
       if [ $# -gt 0 ] && [ "${1:0:1}" != "-" ]; then
         NUMBER="$1"
@@ -44,28 +52,43 @@ fi
 
 while [ $# -gt 0 ]; do
   case "$1" in
-    -s|--state)   STATE="${2:-}"; shift 2;;
-    -l|--limit)   LIMIT="${2:-}"; shift 2;;
-    -t|--title)   TITLE="${2:-}"; shift 2;;
-    -b|--body)    BODY="${2:-}"; shift 2;;
-    --base)       BASE="${2:-}"; shift 2;;
-    --draft)      DRAFT=true; shift;;
-    --fill)       FILL=true; shift;;
-    --json)       JSON=true; shift;;
-    --ai)         AI=true; shift;;
+    -s|--state)         STATE="${2:-}"; shift 2;;
+    -l|--limit)         LIMIT="${2:-}"; shift 2;;
+    -t|--title)         TITLE="${2:-}"; shift 2;;
+    -b|--body)          BODY="${2:-}"; shift 2;;
+    --base)             BASE="${2:-}"; shift 2;;
+    --draft)            DRAFT=true; shift;;
+    --fill)             FILL=true; shift;;
+    --json)             JSON=true; shift;;
+    --ai)               AI=true; shift;;
+    --diff)             INCLUDE_DIFF=true; shift;;
+    --comments)         INCLUDE_COMMENTS=true; shift;;
+    --squash)           MERGE_METHOD="squash"; shift;;
+    --merge)            MERGE_METHOD="merge"; shift;;
+    --rebase)           MERGE_METHOD="rebase"; shift;;
+    --approve)          REVIEW_KIND="approve"; shift;;
+    --request-changes)  REVIEW_KIND="request-changes"; shift;;
+    --comment-review)   REVIEW_KIND="comment"; shift;;
     -h|--help)
       cat <<'EOF'
-fledge github prs — list, view, and create GitHub pull requests
+fledge github prs — manage GitHub pull requests via the gh CLI
 
 USAGE:
-  fledge github prs [list]                List open PRs (default)
-  fledge github prs view <NUMBER>         View a specific PR
-  fledge github prs create                Create a new PR
+  fledge github prs [list]                          List open PRs (default)
+  fledge github prs view <NUMBER>                   View a specific PR
+  fledge github prs create                          Create a new PR
+  fledge github prs comment <NUMBER> -b BODY        Post a comment
+  fledge github prs review <NUMBER> ...             Submit a review
+  fledge github prs merge <NUMBER> [--squash|...]   Merge the PR
+  fledge github prs close <NUMBER>                  Close without merging
+  fledge github prs reopen <NUMBER>                 Reopen a closed PR
 
 LIST / VIEW OPTIONS:
   -s, --state <STATE>   open | closed | merged | all  (default: open)
   -l, --limit <N>       Maximum results (default: 20)
       --json            Output JSON
+      --diff            (view) Append the unified diff
+      --comments        (view) Append PR conversation comments + reviews
 
 CREATE OPTIONS:
   -t, --title <TITLE>   PR title
@@ -76,14 +99,33 @@ CREATE OPTIONS:
       --ai              Generate title and body using AI (fledge ask)
       --json            Output JSON (number, url, title)
 
+COMMENT OPTIONS:
+  -b, --body <BODY>     Comment body (required)
+      --json            Output JSON (url)
+
+REVIEW OPTIONS:
+  One of:
+      --approve           Approve the PR
+      --request-changes   Request changes (requires --body)
+      --comment-review    Submit a review-comment (no approval/blocking)
+  -b, --body <BODY>     Review body (required for --request-changes /
+                        --comment-review, optional for --approve)
+
+MERGE OPTIONS:
+      --squash          Squash-merge (default)
+      --merge           Merge commit
+      --rebase          Rebase-merge
+
 EXAMPLES:
   fledge github prs
   fledge github prs --state merged --limit 5
-  fledge github prs view 256 --json
+  fledge github prs view 256 --diff --comments
   fledge github prs create --fill
-  fledge github prs create --title "My feature" --draft
-  fledge github prs create --ai
-  fledge github prs create --ai --draft
+  fledge github prs comment 256 -b "Looks good — one nit inline."
+  fledge github prs review 256 --approve
+  fledge github prs review 256 --request-changes -b "See comments."
+  fledge github prs merge 256 --squash
+  fledge github prs close 256
 EOF
       exit 0
       ;;
@@ -99,16 +141,90 @@ if ! command -v gh >/dev/null 2>&1; then
   exit 127
 fi
 
+# All non-list actions except 'create' need a number.
+case "$ACTION" in
+  view|comment|review|merge|close|reopen)
+    if [ -z "$NUMBER" ]; then
+      echo "fledge github prs: '$ACTION' requires a PR number. Try: fledge github prs $ACTION 256" >&2
+      exit 64
+    fi
+    ;;
+esac
+
 if [ "$ACTION" = "view" ]; then
-  if [ -z "$NUMBER" ]; then
-    echo "fledge github prs: 'view' requires a PR number. Try: fledge github prs view 256" >&2
-    exit 64
-  fi
   if [ "$JSON" = "true" ]; then
     gh pr view "$NUMBER" --json number,title,state,author,body,labels,createdAt,updatedAt,url,baseRefName,headRefName,isDraft,mergeable,statusCheckRollup
   else
     gh pr view "$NUMBER"
   fi
+  # Optional appendices below the main view block. Each section is
+  # gated by its own flag and separated by a blank line so the output
+  # reads like a single document. `--json` skips both — JSON callers
+  # should fetch what they need with structured calls instead of
+  # parsing concatenated streams.
+  if [ "$JSON" != "true" ] && [ "$INCLUDE_COMMENTS" = "true" ]; then
+    printf '\n--- Comments + Reviews ---\n'
+    gh pr view "$NUMBER" --comments
+  fi
+  if [ "$JSON" != "true" ] && [ "$INCLUDE_DIFF" = "true" ]; then
+    printf '\n--- Diff ---\n'
+    gh pr diff "$NUMBER"
+  fi
+  exit 0
+fi
+
+if [ "$ACTION" = "comment" ]; then
+  if [ -z "$BODY" ]; then
+    echo "fledge github prs: 'comment' requires --body" >&2
+    exit 64
+  fi
+  if [ "$JSON" = "true" ]; then
+    # gh pr comment prints the comment URL to stdout when -b is used;
+    # wrap that in a tiny JSON shape so callers can parse it uniformly.
+    URL="$(gh pr comment "$NUMBER" -b "$BODY")"
+    printf '{"url":"%s"}\n' "$URL"
+  else
+    gh pr comment "$NUMBER" -b "$BODY"
+  fi
+  exit 0
+fi
+
+if [ "$ACTION" = "review" ]; then
+  if [ -z "$REVIEW_KIND" ]; then
+    echo "fledge github prs: 'review' requires --approve, --request-changes, or --comment-review" >&2
+    exit 64
+  fi
+  if [ "$REVIEW_KIND" != "approve" ] && [ -z "$BODY" ]; then
+    echo "fledge github prs: '--$REVIEW_KIND' requires --body" >&2
+    exit 64
+  fi
+  ARGS=("$NUMBER")
+  case "$REVIEW_KIND" in
+    approve)         ARGS+=(--approve);;
+    request-changes) ARGS+=(--request-changes);;
+    comment)         ARGS+=(--comment);;
+  esac
+  [ -n "$BODY" ] && ARGS+=(--body "$BODY")
+  gh pr review "${ARGS[@]}"
+  exit 0
+fi
+
+if [ "$ACTION" = "merge" ]; then
+  case "$MERGE_METHOD" in
+    squash) gh pr merge "$NUMBER" --squash;;
+    merge)  gh pr merge "$NUMBER" --merge;;
+    rebase) gh pr merge "$NUMBER" --rebase;;
+  esac
+  exit 0
+fi
+
+if [ "$ACTION" = "close" ]; then
+  gh pr close "$NUMBER"
+  exit 0
+fi
+
+if [ "$ACTION" = "reopen" ]; then
+  gh pr reopen "$NUMBER"
   exit 0
 fi
 
diff --git a/bin/fledge-github-repo b/bin/fledge-github-repo
new file mode 100755
index 0000000..c4f2223
--- /dev/null
+++ b/bin/fledge-github-repo
@@ -0,0 +1,128 @@
+#!/usr/bin/env bash
+# fledge-github-repo — read GitHub repo metadata and file contents via gh.
+# Invoked via: fledge github repo [view | file <path>] [OPTIONS]
+#
+# `view` returns the current repo's metadata (default-branch, description,
+# topics, etc.). `file <path>` reads a file from a remote repo at an
+# optional ref — wraps `gh api` against /repos/{owner}/{repo}/contents/...
+# Closes the gap where agents kept trying to web-fetch
+# https://raw.githubusercontent.com/... and failing on auth/redirects.
+set -euo pipefail
+
+ACTION="view"
+REPO=""
+REF=""
+PATH_ARG=""
+JSON=false
+
+if [ $# -gt 0 ] && [ "${1:0:1}" != "-" ]; then
+  case "$1" in
+    view)
+      ACTION="view"
+      shift
+      ;;
+    file)
+      ACTION="file"
+      shift
+      if [ $# -gt 0 ] && [ "${1:0:1}" != "-" ]; then
+        PATH_ARG="$1"
+        shift
+      fi
+      ;;
+  esac
+fi
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    -R|--repo)   REPO="${2:-}"; shift 2;;
+    -r|--ref)    REF="${2:-}"; shift 2;;
+    --json)      JSON=true; shift;;
+    -h|--help)
+      cat <<'EOF'
+fledge github repo — read repo metadata and file contents via the gh CLI
+
+USAGE:
+  fledge github repo [view]                      View repo metadata (default)
+  fledge github repo file <PATH>                 Read a file from the repo
+
+OPTIONS:
+  -R, --repo <OWNER/NAME>   Target repo (default: current working repo)
+  -r, --ref <REF>           Branch / tag / SHA (file only; default: repo default)
+      --json                Output JSON
+
+EXAMPLES:
+  fledge github repo
+  fledge github repo view -R CorvidLabs/merlin
+  fledge github repo file CHANGELOG.md
+  fledge github repo file README.md -R CorvidLabs/fledge-plugin-github
+  fledge github repo file Cargo.toml -r v0.3.0
+EOF
+      exit 0
+      ;;
+    *)
+      echo "fledge github repo: unknown argument '$1'" >&2
+      exit 64
+      ;;
+  esac
+done
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "fledge github repo: gh CLI is not installed. https://cli.github.com/" >&2
+  exit 127
+fi
+
+if [ "$ACTION" = "view" ]; then
+  # ${ARRAY[@]+...} expansion: with `set -u`, "${EMPTY[@]}" errors on
+  # bash < 4.4. Use the +-form so the expansion only happens when the
+  # array is non-empty.
+  if [ "$JSON" = "true" ]; then
+    if [ -n "$REPO" ]; then
+      gh repo view "$REPO" --json name,nameWithOwner,description,url,defaultBranchRef,isPrivate,isFork,isArchived,visibility,pushedAt,languages
+    else
+      gh repo view --json name,nameWithOwner,description,url,defaultBranchRef,isPrivate,isFork,isArchived,visibility,pushedAt,languages
+    fi
+  else
+    if [ -n "$REPO" ]; then
+      gh repo view "$REPO"
+    else
+      gh repo view
+    fi
+  fi
+  exit 0
+fi
+
+if [ "$ACTION" = "file" ]; then
+  if [ -z "$PATH_ARG" ]; then
+    echo "fledge github repo: 'file' requires a path. Try: fledge github repo file README.md" >&2
+    exit 64
+  fi
+
+  # Resolve owner/name. If --repo wasn't passed, ask gh to figure it
+  # out from the current working dir. Bail with a clear error rather
+  # than silently 404ing if we're not in a repo and no -R was given.
+  if [ -z "$REPO" ]; then
+    REPO="$(gh repo view --json nameWithOwner --jq '.nameWithOwner' 2>/dev/null || true)"
+    if [ -z "$REPO" ]; then
+      echo "fledge github repo file: --repo not given and current directory isn't a gh-recognized repo." >&2
+      exit 64
+    fi
+  fi
+
+  # Build the contents API endpoint with optional ?ref=<REF>.
+  ENDPOINT="repos/${REPO}/contents/${PATH_ARG}"
+  if [ -n "$REF" ]; then
+    ENDPOINT="${ENDPOINT}?ref=${REF}"
+  fi
+
+  if [ "$JSON" = "true" ]; then
+    # Pass through the raw API response — caller decodes content
+    # themselves if they want the base64.
+    gh api "$ENDPOINT"
+  else
+    # Default: emit just the decoded file contents. The contents API
+    # returns base64-encoded content for files; the .content field
+    # holds it with embedded newlines that base64(1) tolerates.
+    gh api "$ENDPOINT" --jq '.content' | base64 -d
+  fi
+  exit 0
+fi
diff --git a/plugin.toml b/plugin.toml
index ce04779..4852284 100644
--- a/plugin.toml
+++ b/plugin.toml
@@ -1,14 +1,14 @@
 [plugin]
 name = "fledge-plugin-github"
-version = "0.5.0"
-description = "GitHub commands for fledge — view CI checks, issues, pull requests, and poll for daemon events via the gh CLI"
+version = "0.6.0"
+description = "GitHub commands for fledge — list/view/create/comment/review/merge PRs, list/view/create/comment/close issues, read repo files, view CI checks, and poll for daemon events via the gh CLI"
 author = "0xLeif"
 license = "MIT"
 
 [[commands]]
 name = "github"
-description = "GitHub commands via the gh CLI. Subcommands: checks (CI status), issues (list/view <num>), prs (list/view <num>/create), poll (daemon event polling)."
+description = "GitHub commands via the gh CLI. Subcommands: prs (list/view <num> [--diff --comments]/create/comment <num> -b BODY/review <num> --approve|--request-changes|--comment-review -b BODY/merge <num>/close <num>/reopen <num>), issues (list/view <num> [--comments]/create/comment <num> -b BODY/close <num>/reopen <num>), repo (view / file <path> [--ref REF] [-R OWNER/NAME]), checks (CI status), poll (daemon event polling)."
 binary = "bin/fledge-github"
 args = [
-    { name = "args", type = "string", required = true, description = "Subcommand and options, e.g. 'prs view 208', 'prs list --state open', 'issues list', 'issues view 42', 'checks'" },
+    { name = "args", type = "string", required = true, description = "Subcommand and options, e.g. 'prs view 208 --diff', 'prs comment 208 -b \"LGTM\"', 'issues create -t \"Bug\" -b \"...\"', 'repo file CHANGELOG.md -R CorvidLabs/merlin'" },
 ]