diff --git a/docs/fish-config.1 b/docs/fish-config.1
index 272249e..15619a7 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -2877,14 +2877,19 @@ no session-end hook, so its memory is captured on the next launch
 rather than at session end.
 
 Arguments are forwarded verbatim to the real agy binary, except for
--r/--resume which are translated to -c/--continue.
+-r/--resume which use different syntax in agy than claude: bare
+-r/--resume (no session id following) translate to -c/--continue
+(resume most-recent session); -r/--resume given a session id (via
+=id or a following bare word) translate to --conversation(=id)
+(open that specific session).
 
 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  Arguments forwarded to the underlying agy binary (-r translates to -c)
+  ARGS  Arguments forwarded to the underlying agy binary (-r/--resume
+        translate to -c/--continue or --conversation, see DESCRIPTION)
 
 Exit Status:
   Exit status of the underlying agy binary
@@ -2892,6 +2897,7 @@ Exit Status:
 Example:
 agy
 agy --resume
+agy --resume=5fffb251-2cd6-4cfe-8dac-b5e913a86db6
 agy -i \[dq]initial prompt\[dq]
 agy models
 \f[R]
diff --git a/docs/fish-config.md b/docs/fish-config.md
index e8b564a..8c4219d 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -2346,14 +2346,19 @@ functions). They are active in all interactive sessions.
     rather than at session end.
 
     Arguments are forwarded verbatim to the real agy binary, except for
-    -r/--resume which are translated to -c/--continue.
+    -r/--resume which use different syntax in agy than claude: bare
+    -r/--resume (no session id following) translate to -c/--continue
+    (resume most-recent session); -r/--resume given a session id (via
+    =id or a following bare word) translate to --conversation(=id)
+    (open that specific session).
 
     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  Arguments forwarded to the underlying agy binary (-r translates to -c)
+      ARGS  Arguments forwarded to the underlying agy binary (-r/--resume
+            translate to -c/--continue or --conversation, see DESCRIPTION)
 
     Exit Status:
       Exit status of the underlying agy binary
@@ -2361,6 +2366,7 @@ functions). They are active in all interactive sessions.
     Example:
     agy
     agy --resume
+    agy --resume=5fffb251-2cd6-4cfe-8dac-b5e913a86db6
     agy -i "initial prompt"
     agy models