Bash Aliases Management

Manage git shortcuts (g, gco, gb, etc.) and Claude Code aliases (claude-yolo, claude-cont, etc.) with bash tab completion.

Usage

/git:bash-aliases                # Interactive setup wizard
/git:bash-aliases --setup        # Same as above
/git:bash-aliases --status       # Check installation status
/git:bash-aliases --audit        # Comprehensive health check
/git:bash-aliases --uninstall    # Show uninstall instructions

Workflow

Step 1: Parse Arguments

Parse $ARGUMENTS to determine operation mode:

• No arguments or --setup -> Interactive mode (Step 2)
• Direct flag (--status, --audit, --uninstall) -> Direct mode (Step 3)

Step 2: Interactive Mode (no flag or --setup)

Use AskUserQuestion to let user select alias sets:

Use AskUserQuestion with:
- question: "Which bash aliases do you want to install?"
- header: "Alias Sets"
- multiSelect: true
- options:
  1. "Git aliases" - "Shortcuts (g, gco, gb, gm, etc.) with tab completion"
  2. "Claude aliases" - "Claude Code shortcuts (claude-yolo, claude-cont, etc.)"

Based on user selections, execute corresponding script operations:

• Git aliases selected -> Run script with --install-git-aliases
• Claude aliases selected -> Run script with --install-claude-aliases

Report aggregate results.

Step 3: Direct Mode

Execute the script with the specified flag:

Flag	Script Operation
--status	--status
--audit	--audit
--uninstall	--uninstall

Step 4: Report Results

Show operation results to user. Include next steps if applicable:

• After install: "Run source ~/.bashrc or restart your shell"
• For audit warnings: Suggest remediation

Script Location

The underlying bash script is at:

plugins/git/skills/setup/scripts/bash-aliases.sh

Execute using:

bash "plugins/git/skills/setup/scripts/bash-aliases.sh" <operation>

Alias Sets

Git Aliases

Common shortcuts with tab completion:

Alias	Command
g	git
gs	git status
gco	git checkout
gb	git branch
gm	git merge
gp	git pull
gps	git push
gd	git diff
gl	git log --oneline --graph --decorate
gst	git stash
ga	git add
gcm	git commit
gr	git rebase
gcp	git cherry-pick

Claude Code Aliases

Alias	Command
claude-cont	claude -c
claude-cont-yolo	claude -c --dangerously-skip-permissions
claude-yolo	claude --dangerously-skip-permissions
claude-plan	claude --permission-mode plan
claude-opus	claude --model opus
claude-sonnet	claude --model sonnet
claude-opus-yolo	claude --model opus --dangerously-skip-permissions
claude-headless	claude -p --output-format json

Examples

Interactive Setup

/git:bash-aliases
-> "Which bash aliases do you want to install?"
  [x] Git aliases
  [x] Claude aliases
-> Installing selected alias sets...
-> Done! Run: source ~/.bashrc

Check Status

/git:bash-aliases --status

Bash Aliases Status
-------------------

Git Aliases:
[OK] Configured in ~/.bashrc
    Aliases: g, gs, gco, gb, gm, gp, gps, gd, gl, gst, ga, gcm, gr, gcp

Claude Code Aliases:
[OK] Configured in ~/.bashrc
    Aliases: claude-cont, claude-yolo, claude-plan, claude-opus, claude-sonnet

Audit

/git:bash-aliases --audit

Bash Aliases Audit Report
=========================
[OK] Git aliases: PASS - Configured
[OK] git-completion.bash: PASS - Found
[OK] Claude aliases: PASS - Configured
[OK] claude CLI: PASS - Found

Overall: PASS

Notes

• Aliases are added to ~/.bashrc with idempotent markers
• Git aliases include tab completion via git-completion.bash
• Safe to run multiple times (won't duplicate entries)
• Requires source ~/.bashrc or new shell to take effect