/alias - List Command Aliases

List all CODITECT command aliases for discoverability.

System Prompt

EXECUTION DIRECTIVE: When /alias is invoked, IMMEDIATELY extract and display all aliases.

Usage

/alias                  # List all aliases
/alias search           # Search for alias
/alias --command NAME   # Show aliases for command
/alias --json           # JSON output

Execution

~/.coditect/scripts/alias.sh
~/.coditect/scripts/alias.sh search
~/.coditect/scripts/alias.sh --command commit

Output Format

======================================================================
  CODITECT Command Aliases
======================================================================

  Command             Aliases
  -------             -------
  /agent              /invoke, /run-agent
  /checkpoint         /ckpt, /save-state
  /cheat              /cheatsheet, /quick-ref, /ref
  /classify           /tag, /categorize
  /commit             /git-commit, /gc
  /component-stats    /stats, /component-count, /counts
  /cx                 /context-export, /export-context
  /cxq                /context-query, /query, /search-context
  /deps-status        /check-deps, /dependency-status
  /encode             /decode, /base64, /urlencode
  /env-check          /check-env, /validate-env
  /health-check       /system-health, /diagnostics
  /json-format        /jq, /json, /format-json
  /orient             /start, /begin
  /port-check         /check-port, /port, /listening
  /recent             /recent-files, /modified, /changed
  /session-log        /log, /slog
  /sync-status        /status, /sync, /all-status
  /track-status       /tracks, /pilot-status, /progress
  /utc-time           /time, /utc
  /uuid               /gen-uuid, /generate-uuid
  /which              /recommend, /suggest-agent, /find-agent

  Total: 23 commands with 68 aliases

  Tip: Use any alias interchangeably with the primary command.

======================================================================

Search Results

$ /alias commit

======================================================================
  Aliases for 'commit'
======================================================================

  Primary:   /commit
  Aliases:   /git-commit, /gc

  Description: Create git commits with smart defaults

======================================================================

Implementation

#!/bin/bash
# Extract aliases from command frontmatter
for cmd in ~/.coditect/commands/*.md; do
    name=$(basename "$cmd" .md)
    aliases=$(grep -A5 "^aliases:" "$cmd" | grep "^- " | sed 's/^- //')
    if [ -n "$aliases" ]; then
        echo "/$name: $aliases"
    fi
done

How Aliases Work

Aliases are defined in command frontmatter:

---
title: /commit
invocation: /commit
aliases:
- /git-commit
- /gc
---

When you invoke /gc, CODITECT recognizes it as an alias for /commit and executes the primary command.

Related Commands

Command	Purpose
/cheat	Quick reference
/shortcut	Keyboard shortcuts
/which	Find commands

---

Version: 1.0.0 Created: 2026-01-15 Author: CODITECT Team