From 35717c7bacdd526df053c2bc1d1429d4e2242d1a Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Fri, 5 Jun 2026 15:06:45 +0200
Subject: [PATCH] docs(tools/forge): add comments --tail and pr-reviews
 --approve/--request-changes/--comment to cheatsheet

---
 docs/tools/forge.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/tools/forge.md b/docs/tools/forge.md
index c7112863..c2223469 100644
--- a/docs/tools/forge.md
+++ b/docs/tools/forge.md
@@ -15,6 +15,7 @@ as a proper Rust binary). Use it instead of ad-hoc curl pipelines.
 ```bash
 hive-forge view 42                          # title + body + comments
 hive-forge comments 42                      # list all comments (human-readable)
+hive-forge comments 42 --tail 10            # last 10 comments (count-then-page; efficient on long threads)
 hive-forge --json comments 42               # same as above, JSON array (global flag)
 hive-forge comment 42 --body "..."          # post comment (inline body)
 hive-forge comment 42 --body-file - <<EOF   # ...or pipe a HEREDOC
@@ -30,6 +31,9 @@ hive-forge issue-edit 42 --title "new title"
 hive-forge pr 42                            # PR metadata as JSON
 hive-forge pr-create --title "..." --head my-branch --push    # also `git push forge my-branch`
 hive-forge pr-reviews 42                    # list reviews on a PR
+hive-forge pr-reviews 42 --approve         # submit APPROVED review
+hive-forge pr-reviews 42 --request-changes -m "msg"  # submit REQUEST_CHANGES review
+hive-forge pr-reviews 42 --comment -m "msg"  # submit COMMENT review
 hive-forge diff 42                          # unified diff (lockfile hunks collapsed by default)
 hive-forge diff 42 --full                   # include unfiltered lockfile hunks
 hive-forge list                             # open issues/PRs