chore(docs): regenerate man page, HTML docs, and wiki

docs/fish-config.1

@@ -72,15 +72,18 @@ The configuration is split across:
 config.fish               Main entry point; sets env vars and PATH
 conf.d/
   abbr.fish               All abbreviations
-  cheat.fish              cheat.sh completions
+  autopair.fish           Auto-pair brackets and quotes (bundled from jorgebucaran/autopair.fish)
+  cheat.fish              cheat.sh tab completions
   done.fish               Desktop notifications for long commands
   first_run.fish          One-time init: Fisher bootstrap, theme, welcome
   key_bindings.fish       Custom key bindings and Vi mode
+  logging-events.fish     C5 --on-variable event handlers; syncs logging state at startup
   paru-wrapper.fish       Auto-generates \[ti]/.local/bin/paru logging wrapper
+  puffer.fish             !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
+  sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
   starship.fish           fish_prompt with OSC 133 shell-integration markers
   tailscale.fish          Tailscale CLI tab completions
   theme.fish              Catppuccin syntax highlight colors
-  sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
   tricks.fish             PATH, bang-bang helpers, bat man pages, aliases
   wakatime.fish           WakaTime shell hook
   yay-wrapper.fish        Auto-generates \[ti]/.local/bin/yay logging wrapper
@@ -526,8 +529,8 @@ sscr        sudo systemctl restart
 .IP
 .nf
 \f[C]
-ag          antigravity
+ag          agy
-ag.         antigravity .
+ag.         agy .
 v           antigravity-ide
 s           wezterm ssh (WezTerm only)
 \f[R]
@@ -1396,15 +1399,20 @@ smart_exit --no-log
 .PP
    *   *   *   *   *
 .SS 5.12 AI and Developer Tools
-.SS antigravity
+.SS agy
 .IP
 .nf
 \f[C]
-Synopsis:  antigravity [args...]
+Synopsis:  agy [args...]
-Runs the agy CLI (Antigravity AI assistant) with noisy deprecation
+Wrapper for the agy Antigravity AI CLI. Before launching, delegates to
-warnings filtered from stderr.
+agents-init --agents to ensure AGENTS/ is scaffolded and CLAUDE.md is
+symlinked to AGENTS/AGENTS.md in the current project, then forwards all
+arguments verbatim to the real agy binary. Command shadow (C1): when
+__fish_config_op_aliases (or the master) is disabled, the call is
+passed through to the real agy binary unchanged.
 
-antigravity chat
+agy chat
+agy resume
 \f[R]
 .fi
 .SS antigravity-ide
@@ -1425,17 +1433,38 @@ file in the current directory, or opens an interactive fzf picker if no
 session file is found.
 \f[R]
 .fi
+.SS agents-init
+.IP
+.nf
+\f[C]
+Synopsis:  agents-init [--agents | --plugins]
+Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
+directories. Creates AGENTS/ as a standalone git repo, initializes
+standard plugin subdirectories (superpowers/, plans/, specs/), moves any
+existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
+them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so
+Claude Code picks up the shared agent instructions. Adds all managed
+paths to .gitignore and auto-commits every change inside the AGENTS/
+sub-repo. Fully idempotent: a second run produces no output and no new
+commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
+--plugins re-runs only the plugin-directory wiring step. Called
+automatically by the claude and agy wrappers on every invocation.
+
+agents-init
+agents-init --agents
+agents-init --plugins
+\f[R]
+.fi
 .SS claude
 .IP
 .nf
 \f[C]
 Synopsis:  claude [args...]
-Wrapper for the claude CLI. Before launching, checks the current
+Wrapper for the claude CLI. Before launching, delegates to agents-init
-directory and the git project root for CLAUDE.md; when it is absent but
+--agents to ensure AGENTS/ is scaffolded and CLAUDE.md is symlinked to
-AGENTS.md is present, creates a relative symlink CLAUDE.md -> AGENTS.md
+AGENTS/AGENTS.md in the current project, then forwards all arguments
-so Claude Code picks up shared agent instructions without duplicating
+verbatim to the real claude binary. Command shadow (C1): when
-the file. All arguments are forwarded verbatim. Command shadow (C1):
+__fish_config_op_aliases (or the master) is disabled, the call is
-when __fish_config_op_aliases (or the master) is disabled, the call is
 passed through to the real claude binary unchanged.
 
 claude

docs/html/3-description.html

@@ -507,15 +507,18 @@ exit</li>
 <pre><code>config.fish               Main entry point; sets env vars and PATH
 conf.d/
   abbr.fish               All abbreviations
-  cheat.fish              cheat.sh completions
+  autopair.fish           Auto-pair brackets and quotes (bundled from jorgebucaran/autopair.fish)
+  cheat.fish              cheat.sh tab completions
   done.fish               Desktop notifications for long commands
   first_run.fish          One-time init: Fisher bootstrap, theme, welcome
   key_bindings.fish       Custom key bindings and Vi mode
+  logging-events.fish     C5 --on-variable event handlers; syncs logging state at startup
   paru-wrapper.fish       Auto-generates ~/.local/bin/paru logging wrapper
+  puffer.fish             !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
+  sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
   starship.fish           fish_prompt with OSC 133 shell-integration markers
   tailscale.fish          Tailscale CLI tab completions
   theme.fish              Catppuccin syntax highlight colors
-  sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
   tricks.fish             PATH, bang-bang helpers, bat man pages, aliases
   wakatime.fish           WakaTime shell hook
   yay-wrapper.fish        Auto-generates ~/.local/bin/yay logging wrapper

docs/html/8-4-abbreviations.html

@@ -579,8 +579,8 @@ ssct        sudo systemctl start
 sscs        sudo systemctl stop
 sscr        sudo systemctl restart</code></pre>
 <h2 data-number="8.8" id="48-ai-assistants">4.8 AI Assistants</h2>
-<pre><code>ag          antigravity
+<pre><code>ag          agy
-ag.         antigravity .
+ag.         agy .
 v           antigravity-ide
 s           wezterm ssh (WezTerm only)</code></pre>
 <h2 data-number="8.9" id="49-history-expansion">4.9 History

docs/html/9-5-functions-reference.html

@@ -945,12 +945,17 @@ smart_exit --no-log</code></pre>
 <hr />
 <h2 data-number="9.12" id="512-ai-and-developer-tools">5.12 AI and
 Developer Tools</h2>
-<h3 data-number="9.12.1" id="antigravity">antigravity</h3>
+<h3 data-number="9.12.1" id="agy">agy</h3>
-<pre><code>Synopsis:  antigravity [args...]
+<pre><code>Synopsis:  agy [args...]
-Runs the agy CLI (Antigravity AI assistant) with noisy deprecation
+Wrapper for the agy Antigravity AI CLI. Before launching, delegates to
-warnings filtered from stderr.
+agents-init --agents to ensure AGENTS/ is scaffolded and CLAUDE.md is
+symlinked to AGENTS/AGENTS.md in the current project, then forwards all
+arguments verbatim to the real agy binary. Command shadow (C1): when
+__fish_config_op_aliases (or the master) is disabled, the call is
+passed through to the real agy binary unchanged.
 
-antigravity chat</code></pre>
+agy chat
+agy resume</code></pre>
 <h3 data-number="9.12.2" id="antigravity-ide">antigravity-ide</h3>
 <pre><code>Synopsis:  antigravity-ide [args...]
 Runs the antigravity-ide editor with warnings filtered.</code></pre>
@@ -959,36 +964,52 @@ Runs the antigravity-ide editor with warnings filtered.</code></pre>
 Resumes the most recent Antigravity session from the .antigravity_session
 file in the current directory, or opens an interactive fzf picker if no
 session file is found.</code></pre>
-<h3 data-number="9.12.4" id="claude">claude</h3>
+<h3 data-number="9.12.4" id="agents-init">agents-init</h3>
+<pre><code>Synopsis:  agents-init [--agents | --plugins]
+Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
+directories. Creates AGENTS/ as a standalone git repo, initializes
+standard plugin subdirectories (superpowers/, plans/, specs/), moves any
+existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
+them with relative symlinks. Also adds CLAUDE.md -&gt; AGENTS/AGENTS.md so
+Claude Code picks up the shared agent instructions. Adds all managed
+paths to .gitignore and auto-commits every change inside the AGENTS/
+sub-repo. Fully idempotent: a second run produces no output and no new
+commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
+--plugins re-runs only the plugin-directory wiring step. Called
+automatically by the claude and agy wrappers on every invocation.
+
+agents-init
+agents-init --agents
+agents-init --plugins</code></pre>
+<h3 data-number="9.12.5" id="claude">claude</h3>
 <pre><code>Synopsis:  claude [args...]
-Wrapper for the claude CLI. Before launching, checks the current
+Wrapper for the claude CLI. Before launching, delegates to agents-init
-directory and the git project root for CLAUDE.md; when it is absent but
+--agents to ensure AGENTS/ is scaffolded and CLAUDE.md is symlinked to
-AGENTS.md is present, creates a relative symlink CLAUDE.md -&gt; AGENTS.md
+AGENTS/AGENTS.md in the current project, then forwards all arguments
-so Claude Code picks up shared agent instructions without duplicating
+verbatim to the real claude binary. Command shadow (C1): when
-the file. All arguments are forwarded verbatim. Command shadow (C1):
+__fish_config_op_aliases (or the master) is disabled, the call is
-when __fish_config_op_aliases (or the master) is disabled, the call is
 passed through to the real claude binary unchanged.
 
 claude
 claude --resume</code></pre>
-<h3 data-number="9.12.5" id="claude-resume">claude-resume</h3>
+<h3 data-number="9.12.6" id="claude-resume">claude-resume</h3>
 <pre><code>Synopsis:  claude-resume
 Resumes the most recent Claude Code session from the .claude_session
 file in the current directory, or opens an interactive fzf picker.</code></pre>
-<h3 data-number="9.12.6" id="claude-docs">claude-docs</h3>
+<h3 data-number="9.12.7" id="claude-docs">claude-docs</h3>
 <pre><code>Synopsis:  claude-docs
 Invokes Claude Code to analyze recent repository changes and update
 README.md, ensuring all documented features and examples are accurate.</code></pre>
-<h3 data-number="9.12.7" id="claude-pr">claude-pr</h3>
+<h3 data-number="9.12.8" id="claude-pr">claude-pr</h3>
 <pre><code>Synopsis:  claude-pr
 Invokes Claude Code to run the full PR workflow: create branch,
 conventional commit, verification, push, and open a PR with a manual
 verification checklist.</code></pre>
-<h3 data-number="9.12.8" id="code-resume">code-resume</h3>
+<h3 data-number="9.12.9" id="code-resume">code-resume</h3>
 <pre><code>Synopsis:  code-resume
 Resumes the most recent AI session (Claude or Antigravity), preferring
 the newest session file found in the current directory.</code></pre>
-<h3 data-number="9.12.9" id="superpowers">superpowers</h3>
+<h3 data-number="9.12.10" id="superpowers">superpowers</h3>
 <pre><code>Synopsis:  superpowers [on|off] [-g]
 Enables or disables the Superpowers plugin for Antigravity and Claude
 Code at workspace/project scope (default) or user scope (-g/--global).

docs/html/index.html

@@ -736,12 +736,13 @@ id="toc-smart_exit">smart_exit</a></li>
 <li><a href="9-5-functions-reference.html#512-ai-and-developer-tools"
 id="toc-512-ai-and-developer-tools">5.12 AI and Developer Tools</a>
 <ul>
-<li><a href="9-5-functions-reference.html#antigravity"
+<li><a href="9-5-functions-reference.html#agy" id="toc-agy">agy</a></li>
-id="toc-antigravity">antigravity</a></li>
 <li><a href="9-5-functions-reference.html#antigravity-ide"
 id="toc-antigravity-ide">antigravity-ide</a></li>
 <li><a href="9-5-functions-reference.html#antigravity-resume"
 id="toc-antigravity-resume">antigravity-resume</a></li>
+<li><a href="9-5-functions-reference.html#agents-init"
+id="toc-agents-init">agents-init</a></li>
 <li><a href="9-5-functions-reference.html#claude"
 id="toc-claude">claude</a></li>
 <li><a href="9-5-functions-reference.html#claude-resume"

docs/wiki/4-abbreviations.md

@@ -112,8 +112,8 @@ Appending n to any :cd* abbreviation also runs nvim after changing dir.
 
 ## 4.8 AI Assistants
 
-    ag          antigravity
+    ag          agy
-    ag.         antigravity .
+    ag.         agy .
     v           antigravity-ide
     s           wezterm ssh (WezTerm only)
 

docs/wiki/5-functions-reference.md

@@ -599,13 +599,18 @@
 
 ## 5.12 AI and Developer Tools
 
-### antigravity
+### agy
 
-    Synopsis:  antigravity [args...]
+    Synopsis:  agy [args...]
-    Runs the agy CLI (Antigravity AI assistant) with noisy deprecation
+    Wrapper for the agy Antigravity AI CLI. Before launching, delegates to
-    warnings filtered from stderr.
+    agents-init --agents to ensure AGENTS/ is scaffolded and CLAUDE.md is
+    symlinked to AGENTS/AGENTS.md in the current project, then forwards all
+    arguments verbatim to the real agy binary. Command shadow (C1): when
+    __fish_config_op_aliases (or the master) is disabled, the call is
+    passed through to the real agy binary unchanged.
 
-    antigravity chat
+    agy chat
+    agy resume
 
 ### antigravity-ide
 
@@ -619,15 +624,33 @@
     file in the current directory, or opens an interactive fzf picker if no
     session file is found.
 
+### agents-init
+
+    Synopsis:  agents-init [--agents | --plugins]
+    Scaffold an AGENTS/ sub-repository for tracking agent specs and plugin
+    directories. Creates AGENTS/ as a standalone git repo, initializes
+    standard plugin subdirectories (superpowers/, plans/, specs/), moves any
+    existing AGENTS.md and docs/plugin dirs into the sub-repo, and replaces
+    them with relative symlinks. Also adds CLAUDE.md -> AGENTS/AGENTS.md so
+    Claude Code picks up the shared agent instructions. Adds all managed
+    paths to .gitignore and auto-commits every change inside the AGENTS/
+    sub-repo. Fully idempotent: a second run produces no output and no new
+    commits. Flags: --agents re-runs only the AGENTS.md / symlink step;
+    --plugins re-runs only the plugin-directory wiring step. Called
+    automatically by the claude and agy wrappers on every invocation.
+
+    agents-init
+    agents-init --agents
+    agents-init --plugins
+
 ### claude
 
     Synopsis:  claude [args...]
-    Wrapper for the claude CLI. Before launching, checks the current
+    Wrapper for the claude CLI. Before launching, delegates to agents-init
-    directory and the git project root for CLAUDE.md; when it is absent but
+    --agents to ensure AGENTS/ is scaffolded and CLAUDE.md is symlinked to
-    AGENTS.md is present, creates a relative symlink CLAUDE.md -> AGENTS.md
+    AGENTS/AGENTS.md in the current project, then forwards all arguments
-    so Claude Code picks up shared agent instructions without duplicating
+    verbatim to the real claude binary. Command shadow (C1): when
-    the file. All arguments are forwarded verbatim. Command shadow (C1):
+    __fish_config_op_aliases (or the master) is disabled, the call is
-    when __fish_config_op_aliases (or the master) is disabled, the call is
     passed through to the real claude binary unchanged.
 
     claude

docs/wiki/index.md

@@ -16,15 +16,18 @@ The configuration is split across:
     config.fish               Main entry point; sets env vars and PATH
     conf.d/
       abbr.fish               All abbreviations
-      cheat.fish              cheat.sh completions
+      autopair.fish           Auto-pair brackets and quotes (bundled from jorgebucaran/autopair.fish)
+      cheat.fish              cheat.sh tab completions
       done.fish               Desktop notifications for long commands
       first_run.fish          One-time init: Fisher bootstrap, theme, welcome
       key_bindings.fish       Custom key bindings and Vi mode
+      logging-events.fish     C5 --on-variable event handlers; syncs logging state at startup
       paru-wrapper.fish       Auto-generates ~/.local/bin/paru logging wrapper
+      puffer.fish             !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
+      sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
       starship.fish           fish_prompt with OSC 133 shell-integration markers
       tailscale.fish          Tailscale CLI tab completions
       theme.fish              Catppuccin syntax highlight colors
-      sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
       tricks.fish             PATH, bang-bang helpers, bat man pages, aliases
       wakatime.fish           WakaTime shell hook
       yay-wrapper.fish        Auto-generates ~/.local/bin/yay logging wrapper