update docs with new rebase flag

Author: skarim

README.md

@@ -209,6 +209,7 @@ If a rebase conflict occurs, the operation pauses and prints the conflicted file
 |------|-------------|
 | `--downstack` | Only rebase branches from trunk to the current branch |
 | `--upstack` | Only rebase branches from the current branch to the top |
+| `--no-trunk` | Skip trunk — only rebase stack branches onto each other (no fetch, no trunk rebase) |
 | `--continue` | Continue the rebase after resolving conflicts |
 | `--abort` | Abort the rebase and restore all branches to their pre-rebase state |
 | `--remote <name>` | Remote to fetch from (defaults to auto-detected remote) |
@@ -230,6 +231,9 @@ gh stack rebase --downstack
 # Only rebase branches above the current one
 gh stack rebase --upstack
 
+# Rebase stack branches without pulling from or rebasing with trunk
+gh stack rebase --no-trunk
+
 # After resolving a conflict
 gh stack rebase --continue
 

docs/src/content/docs/guides/workflows.md

@@ -155,6 +155,9 @@ gh stack rebase --downstack
 
 # Only rebase from the current branch up to the top
 gh stack rebase --upstack
+
+# Rebase stack branches without pulling from or rebasing with trunk
+gh stack rebase --no-trunk
 ```
 
 After rebasing, push the updated branches:

docs/src/content/docs/reference/cli.md

@@ -334,6 +334,7 @@ If a rebase conflict occurs, the operation pauses and prints the conflicted file
 |------|-------------|
 | `--downstack` | Only rebase branches from trunk to the current branch |
 | `--upstack` | Only rebase branches from the current branch to the top |
+| `--no-trunk` | Skip trunk — only rebase stack branches onto each other (no fetch, no trunk rebase) |
 | `--continue` | Continue the rebase after resolving conflicts |
 | `--abort` | Abort the rebase and restore all branches to their pre-rebase state |
 | `--remote <name>` | Remote to fetch from (defaults to auto-detected remote) |
@@ -355,6 +356,9 @@ gh stack rebase --downstack
 # Only rebase branches above the current one
 gh stack rebase --upstack
 
+# Rebase stack branches without pulling from or rebasing with trunk
+gh stack rebase --no-trunk
+
 # After resolving a conflict
 gh stack rebase --continue
 

skills/gh-stack/SKILL.md

@@ -7,7 +7,7 @@ description: >
   branch chains, or incremental code review workflows.
 metadata:
   author: github
-  version: "0.0.5"
+  version: "0.0.6"
 ---
 
 # gh-stack
@@ -155,6 +155,7 @@ Small, incidental fixes (e.g., fixing a typo you noticed) can go in the current
 | Sync and prune merged branches | `gh stack sync --prune` |
 | Rebase entire stack | `gh stack rebase` |
 | Rebase upstack only | `gh stack rebase --upstack` |
+| Rebase without trunk | `gh stack rebase --no-trunk` |
 | Continue after conflict | `gh stack rebase --continue` |
 | Abort rebase | `gh stack rebase --abort` |
 | View stack details (JSON) | `gh stack view --json` |
@@ -663,6 +664,9 @@ gh stack rebase --downstack
 # Rebase only branches from current branch to top
 gh stack rebase --upstack
 
+# Rebase stack branches without pulling from or rebasing with trunk
+gh stack rebase --no-trunk
+
 # After resolving a conflict: stage files with `git add`, then:
 gh stack rebase --continue
 
@@ -674,6 +678,7 @@ gh stack rebase --abort
 |------|-------------|
 | `--downstack` | Only rebase branches from trunk to the current branch |
 | `--upstack` | Only rebase branches from the current branch to the top |
+| `--no-trunk` | Skip trunk — only rebase stack branches onto each other (no fetch, no trunk rebase) |
 | `--continue` | Continue after resolving conflicts |
 | `--abort` | Abort and restore all branches |
 | `--remote <name>` | Remote to fetch from (use if multiple remotes exist) |
@@ -688,6 +693,8 @@ gh stack rebase --abort
 
 **Rerere (conflict memory):** `git rerere` is enabled by `init` so previously resolved conflicts are auto-resolved in future rebases.
 
+**No-trunk mode:** Use `--no-trunk` to skip fetching from the remote and rebasing with the trunk branch. Only inter-branch rebases are performed (branch 2 onto branch 1, branch 3 onto branch 2, etc.). Useful when you only need to align stack branches with each other without pulling upstream changes.
+
 ---
 
 ### View the stack — `gh stack view`