Files
fish-config/functions/superpowers.fish
T
rootiest e651566e14 docs(functions): split RETURNS into EXIT STATUS and stdout RETURNS
RETURNS previously conflated fish's $status exit code with genuine
stdout/printed output, e.g. rm listing "0/1" as if they were print
values rather than exit codes. Rename RETURNS to EXIT STATUS across
all 83 documented functions, and reintroduce RETURNS as a distinct
label reserved for the 15 functions that actually print to stdout.

Update build-manual.py's ENTRY_HEADS to render Exit Status before
Returns, manualtools.py's SECTIONS constant, and AGENTS.md's label
order and label-usage guidance to match. Add two verify-manual.py
regression tests: EXIT STATUS bodies must never contain stray
stdout/printed language, and Returns: must always render after
Exit Status: when both are present. Regenerate docs/fish-config.md.
2026-07-26 16:41:57 -04:00

74 lines
2.0 KiB
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 12-ai-and-developer-tools
#
# SYNOPSIS
# superpowers [on|off] [-g]
#
# DESCRIPTION
# Enables or disables the superpowers plugin for both antigravity-cli
# (workspace scope) and Claude (project scope). Use -g/--global to apply
# at the user scope instead of workspace/project.
#
# ARGUMENTS
# on Enable superpowers for both tools
# off Disable superpowers for both tools
# -g, --global Apply at user/global scope instead of workspace/project
# -h, --help Show usage help
#
# EXIT STATUS
# 0 Mode applied successfully
# 1 No on/off mode specified
#
# EXAMPLE
# superpowers on
# superpowers off -g
function superpowers --description 'Toggle superpowers extension for antigravity-cli and Claude'
set -l scope_agy workspace
set -l scope_claude project
set -l mode ""
set -l help_text "
Usage: superpowers [on|off] [options]
Commands:
on Enable superpowers for antigravity-cli and Claude
off Disable superpowers for antigravity-cli and Claude
Options:
-g, --global Apply settings to the user/global scope
-h, --help Show this help message
"
# Parse arguments
for arg in $argv
switch $arg
case on
set mode enable
case off
set mode disable
case -g --global
set scope_agy user
set scope_claude user
case -h --help
echo $help_text
return 0
end
end
# Handle no arguments or invalid mode
if test -z "$mode"
echo $help_text
return 1
end
echo "Setting superpowers to: $mode (Scope: antigravity-cli=$scope_agy, Claude=$scope_claude)..."
# Execute antigravity-cli command
agy extensions $mode superpowers --scope $scope_agy
# Execute Claude command
claude plugins $mode superpowers --scope $scope_claude
end