diff --git a/docs/fish-config.1 b/docs/fish-config.1
index cc7a06f..2823e7b 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -2419,23 +2419,25 @@ Wrapper for the agy Antigravity AI CLI that ensures the AGENTS/
 sub-repository is initialized and any agent-made changes are committed
 before launch. Delegates all scaffold and commit logic to agents-init
 --quiet (full setup), which ensures AGENTS/ is scaffolded and CLAUDE.md
-is symlinked to AGENTS/AGENTS.md in the current project. All arguments
-are forwarded verbatim to the real agy binary.
+is symlinked to AGENTS/AGENTS.md in the current project. Arguments are
+forwarded verbatim to the real agy binary, except for -r/--resume which
+are translated to -c/--continue.
 
 Opinionated component (C1): when disabled via __fish_config_op_aliases
 (or the __fish_config_opinionated master), the command is passed through
 to the real agy binary unchanged.
 
 Arguments:
-  ARGS  Any arguments forwarded verbatim to the underlying agy binary
+  ARGS  Arguments forwarded to the underlying agy binary (-r translates to -c)
 
 Exit Status:
   Exit status of the underlying agy binary
 
 Example:
 agy
-agy chat
-agy resume
+agy --resume
+agy -i \[dq]initial prompt\[dq]
+agy models
 \f[R]
 .fi
 .PP
diff --git a/docs/fish-config.md b/docs/fish-config.md
index 4a5c534..f6ce2b4 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -1885,23 +1885,25 @@ Add -i (interactive confirmation) to destructive commands:
     sub-repository is initialized and any agent-made changes are committed
     before launch. Delegates all scaffold and commit logic to agents-init
     --quiet (full setup), which ensures AGENTS/ is scaffolded and CLAUDE.md
-    is symlinked to AGENTS/AGENTS.md in the current project. All arguments
-    are forwarded verbatim to the real agy binary.
+    is symlinked to AGENTS/AGENTS.md in the current project. Arguments are
+    forwarded verbatim to the real agy binary, except for -r/--resume which
+    are translated to -c/--continue.
 
     Opinionated component (C1): when disabled via __fish_config_op_aliases
     (or the __fish_config_opinionated master), the command is passed through
     to the real agy binary unchanged.
 
     Arguments:
-      ARGS  Any arguments forwarded verbatim to the underlying agy binary
+      ARGS  Arguments forwarded to the underlying agy binary (-r translates to -c)
 
     Exit Status:
       Exit status of the underlying agy binary
 
     Example:
     agy
-    agy chat
-    agy resume
+    agy --resume
+    agy -i "initial prompt"
+    agy models
 
 **Dependencies:** `agents-init`