From 5c3d1695728b3924fedb166cf30411aba841fc5f Mon Sep 17 00:00:00 2001 From: Gitea Actions Date: Sat, 13 Jun 2026 04:27:04 +0000 Subject: [PATCH] chore(docs): regenerate man page, HTML docs, and wiki --- docs/fish-config.1 | 59 +++++++++++++++++++------- docs/html/3-description.html | 7 ++- docs/html/8-4-abbreviations.html | 4 +- docs/html/9-5-functions-reference.html | 55 ++++++++++++++++-------- docs/html/index.html | 5 ++- docs/html/sitemap.json | 2 +- docs/wiki/4-abbreviations.md | 4 +- docs/wiki/5-functions-reference.md | 45 +++++++++++++++----- docs/wiki/index.md | 7 ++- 9 files changed, 134 insertions(+), 54 deletions(-) diff --git a/docs/fish-config.1 b/docs/fish-config.1 index d3731e3..a4ab56e 100644 --- a/docs/fish-config.1 +++ b/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. antigravity . +ag agy +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...] -Runs the agy CLI (Antigravity AI assistant) with noisy deprecation -warnings filtered from stderr. +Synopsis: agy [args...] +Wrapper for the agy Antigravity AI CLI. Before launching, delegates to +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 -directory and the git project root for CLAUDE.md; when it is absent but -AGENTS.md is present, creates a relative symlink CLAUDE.md -> AGENTS.md -so Claude Code picks up shared agent instructions without duplicating -the file. All arguments are forwarded verbatim. Command shadow (C1): -when __fish_config_op_aliases (or the master) is disabled, the call is +Wrapper for the claude CLI. Before launching, delegates to 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 claude binary. Command shadow (C1): when +__fish_config_op_aliases (or the master) is disabled, the call is passed through to the real claude binary unchanged. claude diff --git a/docs/html/3-description.html b/docs/html/3-description.html index 792fbe1..53933ea 100644 --- a/docs/html/3-description.html +++ b/docs/html/3-description.html @@ -507,15 +507,18 @@ exit 
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
diff --git a/docs/html/8-4-abbreviations.html b/docs/html/8-4-abbreviations.html
index 7256e3b..75ec2e8 100644
--- a/docs/html/8-4-abbreviations.html
+++ b/docs/html/8-4-abbreviations.html
@@ -579,8 +579,8 @@ ssct        sudo systemctl start
 sscs        sudo systemctl stop
 sscr        sudo systemctl restart

4.8 AI Assistants

-
ag          antigravity
-ag.         antigravity .
+
ag          agy
+ag.         agy .
 v           antigravity-ide
 s           wezterm ssh (WezTerm only)

 
4.9 History
diff --git a/docs/html/9-5-functions-reference.html b/docs/html/9-5-functions-reference.html
index 91d3ad7..9faab59 100644
--- a/docs/html/9-5-functions-reference.html
+++ b/docs/html/9-5-functions-reference.html
@@ -945,12 +945,17 @@ smart_exit --no-log

5.12 AI and Developer Tools

-

antigravity

-
Synopsis:  antigravity [args...]
-Runs the agy CLI (Antigravity AI assistant) with noisy deprecation
-warnings filtered from stderr.
+
agy

+
Synopsis:  agy [args...]
+Wrapper for the agy Antigravity AI CLI. Before launching, delegates to
+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

Synopsis:  antigravity-ide [args...]
 Runs the antigravity-ide editor with warnings filtered.
@@ -959,36 +964,52 @@ Runs the antigravity-ide editor with warnings filtered. 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. -

claude

+

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
-directory and the git project root for CLAUDE.md; when it is absent but
-AGENTS.md is present, creates a relative symlink CLAUDE.md -> AGENTS.md
-so Claude Code picks up shared agent instructions without duplicating
-the file. All arguments are forwarded verbatim. Command shadow (C1):
-when __fish_config_op_aliases (or the master) is disabled, the call is
+Wrapper for the claude CLI. Before launching, delegates to 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 claude binary. Command shadow (C1): when
+__fish_config_op_aliases (or the master) is disabled, the call is
 passed through to the real claude binary unchanged.
 
 claude
 claude --resume
-

claude-resume

+

claude-resume

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.
-

claude-docs

+

claude-docs

Synopsis:  claude-docs
 Invokes Claude Code to analyze recent repository changes and update
 README.md, ensuring all documented features and examples are accurate.
-

claude-pr

+

claude-pr

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-resume

+

code-resume

Synopsis:  code-resume
 Resumes the most recent AI session (Claude or Antigravity), preferring
 the newest session file found in the current directory.
-

superpowers

+

superpowers

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).
diff --git a/docs/html/index.html b/docs/html/index.html
index 8d6cecb..c66fd81 100644
--- a/docs/html/index.html
+++ b/docs/html/index.html
@@ -736,12 +736,13 @@ id="toc-smart_exit">smart_exit
 
  • 5.12 AI and Developer Tools