oasr 0.5.1__py3-none-any.whl → 0.5.2__py3-none-any.whl

cli.py

@@ -13,7 +13,7 @@ from pathlib import Path
 from commands import adapter, clean, clone, config, diff, exec, find, registry, sync, update, use, validate
 from commands import help as help_cmd
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"
 
 
 def main(argv: list[str] | None = None) -> int:
@@ -88,6 +88,11 @@ def create_parser() -> argparse.ArgumentParser:
 
     info_cmd.register(subparsers)
 
+    # Import and register completion command
+    from commands import completion as completion_cmd
+
+    completion_cmd.register_parser(subparsers)
+
     help_cmd.register(subparsers, parser)
 
     return parser

commands/completion.py

@@ -0,0 +1,345 @@
+"""Shell completion management for OASR."""
+
+import os
+import platform
+import sys
+from pathlib import Path
+
+from config import load_config
+
+
+def register_parser(subparsers):
+    """Register the completion subcommand."""
+    parser = subparsers.add_parser(
+        "completion",
+        help="Generate and install shell completions",
+        description="Generate shell completion scripts for bash, zsh, fish, and PowerShell.",
+    )
+
+    parser.add_argument(
+        "shell",
+        nargs="?",
+        choices=["bash", "zsh", "fish", "powershell", "install", "uninstall"],
+        help="Shell type or action (install/uninstall)",
+    )
+
+    parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force installation even if already installed",
+    )
+
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be done without doing it",
+    )
+
+    parser.set_defaults(func=run)
+
+
+def detect_shell():
+    """
+    Auto-detect the user's shell based on platform and environment.
+
+    Returns:
+        str: Shell name (bash, zsh, fish, powershell)
+    """
+    if platform.system() == "Windows":
+        shell_env = os.environ.get("SHELL", "").lower()
+        if "bash" in shell_env:
+            return "bash"
+        # Check for PowerShell
+        if "PSModulePath" in os.environ or "POWERSHELL" in os.environ.get("SHELL", "").upper():
+            return "powershell"
+        if "zsh" in shell_env:
+            return "zsh"
+        if "fish" in shell_env:
+            return "fish"
+        # Default to PowerShell on Windows
+        return "powershell"
+    else:
+        # Linux/macOS
+        shell = os.environ.get("SHELL", "")
+        if "zsh" in shell:
+            return "zsh"
+        elif "fish" in shell:
+            return "fish"
+        else:
+            # Default to bash on Unix
+            return "bash"
+
+
+def get_completion_script(shell):
+    """
+    Get the completion script content for the specified shell.
+
+    Args:
+        shell: Shell name (bash, zsh, fish, powershell)
+
+    Returns:
+        str: Completion script content
+    """
+    # Map shell names to completion files
+    script_files = {
+        "bash": "bash.sh",
+        "zsh": "zsh.sh",
+        "fish": "fish.fish",
+        "powershell": "powershell.ps1",
+    }
+
+    if shell not in script_files:
+        return ""
+
+    # Get the path to the completion script
+    completion_file = Path(__file__).parent.parent / "completions" / script_files[shell]
+
+    if not completion_file.exists():
+        return f"# {shell} completion script not found"
+
+    return completion_file.read_text()
+
+
+def get_completion_path(shell, system=False):
+    """
+    Get the installation path for completion script.
+
+    Args:
+        shell: Shell name
+        system: If True, use system-wide path (requires root)
+
+    Returns:
+        Path: Installation path
+    """
+    paths = {
+        "bash": {
+            "user": Path.home() / ".bash_completion.d" / "oasr",
+            "system": Path("/etc/bash_completion.d/oasr"),
+        },
+        "zsh": {
+            "user": Path.home() / ".zsh" / "completion" / "_oasr",
+            "system": Path("/usr/local/share/zsh/site-functions/_oasr"),
+        },
+        "fish": {
+            "user": Path.home() / ".config" / "fish" / "completions" / "oasr.fish",
+            "system": Path("/usr/share/fish/vendor_completions.d/oasr.fish"),
+        },
+        "powershell": {
+            "user": Path.home() / ".config" / "powershell" / "oasr_completion.ps1",
+            "system": Path.home() / ".config" / "powershell" / "oasr_completion.ps1",
+        },
+    }
+
+    level = "system" if system else "user"
+    return paths.get(shell, {}).get(level)
+
+
+def print_activation_instructions(shell, path):
+    """
+    Print instructions for activating completions.
+
+    Args:
+        shell: Shell name
+        path: Installation path
+    """
+    instructions = {
+        "bash": f"""
+✓ Completions installed for bash
+
+To activate, add this to your ~/.bashrc:
+    source {path}
+
+Or run:
+    echo 'source {path}' >> ~/.bashrc
+
+Then restart your shell or run:
+    source ~/.bashrc
+""",
+        "zsh": f"""
+✓ Completions installed for zsh
+
+To activate, add this to your ~/.zshrc:
+    fpath=({path.parent} $fpath)
+    autoload -Uz compinit && compinit
+
+Then restart your shell or run:
+    source ~/.zshrc
+""",
+        "fish": f"""
+✓ Completions installed for fish
+
+Completions will be active in new fish shells.
+To activate now, run:
+    source {path}
+""",
+        "powershell": f"""
+✓ Completions installed for PowerShell
+
+To activate, add this to your PowerShell profile ($PROFILE):
+    . {path}
+
+Or run:
+    echo '. {path}' >> $PROFILE
+
+Then restart PowerShell or run:
+    . $PROFILE
+""",
+    }
+
+    print(instructions.get(shell, ""))
+
+
+def is_already_installed(shell):
+    """
+    Check if completions are already installed for the shell.
+
+    Args:
+        shell: Shell name
+
+    Returns:
+        bool: True if already installed
+    """
+    path = get_completion_path(shell)
+    if not path or not path.exists():
+        return False
+
+    # Check for our signature
+    with open(path) as f:
+        content = f.read()
+        return "# oasr completion" in content.lower()
+
+
+def run_output(shell):
+    """
+    Output the completion script to stdout.
+
+    Args:
+        shell: Shell name
+
+    Returns:
+        int: Exit code
+    """
+    script = get_completion_script(shell)
+    print(script)
+    return 0
+
+
+def run_install(args):
+    """
+    Install completion script.
+
+    Args:
+        args: Parsed arguments
+
+    Returns:
+        int: Exit code
+    """
+    shell = args.shell if args.shell != "install" else detect_shell()
+
+    # Check config
+    config = load_config()
+    if not config.get("oasr", {}).get("completions", True):
+        print("Completions are disabled in config (oasr.completions = false)")
+        return 1
+
+    # Check if already installed
+    if is_already_installed(shell) and not args.force:
+        print(f"✓ Completions already installed for {shell}")
+        print("  Use --force to reinstall")
+        return 0
+
+    # Get paths
+    path = get_completion_path(shell)
+    if not path:
+        print(f"Error: Unsupported shell: {shell}", file=sys.stderr)
+        return 1
+
+    # Dry run
+    if args.dry_run:
+        print(f"Would install completion to: {path}")
+        print_activation_instructions(shell, path)
+        return 0
+
+    # Get script
+    script = get_completion_script(shell)
+
+    # Create directory
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Backup existing
+    if path.exists() and not is_already_installed(shell):
+        import time
+
+        backup = path.parent / f"{path.name}.backup.{int(time.time())}"
+        path.rename(backup)
+        print(f"Backed up existing file to: {backup}")
+
+    # Write script
+    path.write_text(script)
+
+    # Success message
+    print_activation_instructions(shell, path)
+
+    return 0
+
+
+def run_uninstall(args):
+    """
+    Uninstall completion script.
+
+    Args:
+        args: Parsed arguments
+
+    Returns:
+        int: Exit code
+    """
+    shell = args.shell if args.shell != "uninstall" else detect_shell()
+
+    path = get_completion_path(shell)
+    if not path or not path.exists():
+        print(f"No completions installed for {shell}")
+        return 0
+
+    # Dry run
+    if args.dry_run:
+        print(f"Would remove: {path}")
+        return 0
+
+    # Remove file
+    path.unlink()
+    print(f"✓ Removed completions for {shell}")
+
+    return 0
+
+
+def run(args):
+    """
+    Execute completion command.
+
+    Args:
+        args: Parsed arguments
+
+    Returns:
+        int: Exit code
+    """
+    # No shell specified - show help
+    if not args.shell:
+        detected = detect_shell()
+        print(f"Detected shell: {detected}")
+        print("\nUsage:")
+        print("  oasr completion bash          # Output bash completion script")
+        print("  oasr completion zsh           # Output zsh completion script")
+        print("  oasr completion fish          # Output fish completion script")
+        print("  oasr completion powershell    # Output PowerShell completion script")
+        print("  oasr completion install       # Auto-detect and install")
+        print("  oasr completion uninstall     # Remove installed completions")
+        return 0
+
+    # Handle actions
+    if args.shell == "install":
+        return run_install(args)
+    elif args.shell == "uninstall":
+        return run_uninstall(args)
+    else:
+        # Output script to stdout
+        return run_output(args.shell)

completions/__init__.py

@@ -0,0 +1 @@
+"""Shell completion scripts for OASR."""

completions/bash.sh

@@ -0,0 +1,197 @@
+# oasr completion for bash
+# This file provides tab completion for the oasr command in bash.
+#
+# Installation:
+#   Run: oasr completion install
+#   Or manually: source this file in your ~/.bashrc
+
+_oasr_skills() {
+    # Get skill names from registry
+    local skills
+    skills=$(oasr registry list --quiet 2>/dev/null | grep "^  -" | sed 's/^  - //' | awk '{print $1}')
+    COMPREPLY=($(compgen -W "$skills" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+
+_oasr_agents() {
+    # Known agent names
+    COMPREPLY=($(compgen -W "codex copilot claude opencode" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+
+_oasr_profiles() {
+    # Get profile names from config
+    local profiles
+    profiles=$(oasr config list 2>/dev/null | grep "^profiles\." | sed 's/^profiles\.\([^=]*\)=.*/\1/' | sort -u)
+    COMPREPLY=($(compgen -W "$profiles" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+
+_oasr_config_keys() {
+    # Common config keys
+    COMPREPLY=($(compgen -W "agent profile adapter.default validation.strict validation.show_references oasr.completions" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+
+_oasr_completion_shells() {
+    COMPREPLY=($(compgen -W "bash zsh fish powershell install uninstall" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+
+_oasr() {
+    local cur prev words cword
+    _init_completion || return
+
+    # Top-level commands
+    if [ $COMP_CWORD -eq 1 ]; then
+        COMPREPLY=($(compgen -W "registry diff sync config clone exec use find validate clean adapter update info help completion" -- "$cur"))
+        return 0
+    fi
+
+    # Get the main command
+    local command="${COMP_WORDS[1]}"
+
+    case "$command" in
+        exec)
+            case "$prev" in
+                --agent)
+                    _oasr_agents
+                    return 0
+                    ;;
+                --profile)
+                    _oasr_profiles
+                    return 0
+                    ;;
+                --agent-flags)
+                    # No completion for agent flags
+                    return 0
+                    ;;
+                -p|--prompt)
+                    # File completion for prompt
+                    _filedir
+                    return 0
+                    ;;
+                *)
+                    # Complete skill names and flags
+                    if [[ "$cur" == -* ]]; then
+                        COMPREPLY=($(compgen -W "--agent --profile --agent-flags -y --yes --confirm -p --prompt" -- "$cur"))
+                    else
+                        _oasr_skills
+                    fi
+                    return 0
+                    ;;
+            esac
+            ;;
+
+        clone)
+            case "$prev" in
+                -t|--target)
+                    # Directory completion
+                    _filedir -d
+                    return 0
+                    ;;
+                *)
+                    if [[ "$cur" == -* ]]; then
+                        COMPREPLY=($(compgen -W "-t --target" -- "$cur"))
+                    else
+                        _oasr_skills
+                    fi
+                    return 0
+                    ;;
+            esac
+            ;;
+
+        info|validate)
+            if [[ "$cur" == -* ]]; then
+                case "$command" in
+                    info)
+                        COMPREPLY=($(compgen -W "--files" -- "$cur"))
+                        ;;
+                esac
+            else
+                _oasr_skills
+            fi
+            return 0
+            ;;
+
+        config)
+            if [ $COMP_CWORD -eq 2 ]; then
+                COMPREPLY=($(compgen -W "set get list path" -- "$cur"))
+                return 0
+            fi
+
+            local subcommand="${COMP_WORDS[2]}"
+            case "$subcommand" in
+                set|get)
+                    if [ $COMP_CWORD -eq 3 ]; then
+                        _oasr_config_keys
+                    elif [ $COMP_CWORD -eq 4 ] && [ "$subcommand" = "set" ]; then
+                        # Value completion based on key
+                        local key="${COMP_WORDS[3]}"
+                        case "$key" in
+                            agent)
+                                _oasr_agents
+                                ;;
+                            profile)
+                                _oasr_profiles
+                                ;;
+                            validation.strict|oasr.completions)
+                                COMPREPLY=($(compgen -W "true false" -- "$cur"))
+                                ;;
+                        esac
+                    fi
+                    return 0
+                    ;;
+            esac
+            ;;
+
+        registry)
+            if [ $COMP_CWORD -eq 2 ]; then
+                COMPREPLY=($(compgen -W "add rm sync list validate prune" -- "$cur"))
+                return 0
+            fi
+
+            local subcommand="${COMP_WORDS[2]}"
+            case "$subcommand" in
+                add)
+                    # Directory or URL completion
+                    if [[ "$cur" == http* ]] || [[ "$cur" == git@* ]]; then
+                        # No completion for URLs
+                        return 0
+                    else
+                        _filedir -d
+                    fi
+                    ;;
+                rm)
+                    _oasr_skills
+                    ;;
+                prune)
+                    if [[ "$cur" == -* ]]; then
+                        COMPREPLY=($(compgen -W "--dry-run" -- "$cur"))
+                    fi
+                    ;;
+            esac
+            ;;
+
+        completion)
+            if [ $COMP_CWORD -eq 2 ]; then
+                _oasr_completion_shells
+                return 0
+            fi
+            
+            if [[ "$cur" == -* ]]; then
+                COMPREPLY=($(compgen -W "--force --dry-run" -- "$cur"))
+            fi
+            ;;
+
+        adapter)
+            if [ $COMP_CWORD -eq 2 ]; then
+                COMPREPLY=($(compgen -W "list generate" -- "$cur"))
+                return 0
+            fi
+            ;;
+
+        find|validate|sync|diff|clean|update|help)
+            # These commands have limited or no additional completion
+            return 0
+            ;;
+    esac
+}
+
+# Register the completion function
+complete -F _oasr oasr

completions/fish.fish

@@ -0,0 +1,120 @@
+# oasr completion for fish
+# This file provides tab completion for the oasr command in fish.
+#
+# Installation:
+#   Run: oasr completion install
+#   Or manually: Copy to ~/.config/fish/completions/oasr.fish
+
+# Helper functions for dynamic completion
+function __oasr_skills
+    oasr registry list --quiet 2>/dev/null | grep '^  -' | sed 's/^  - //' | awk '{print $1}'
+end
+
+function __oasr_agents
+    echo codex
+    echo copilot
+    echo claude
+    echo opencode
+end
+
+function __oasr_profiles
+    oasr config list 2>/dev/null | grep '^profiles\.' | sed 's/^profiles\.\([^=]*\)=.*/\1/' | sort -u
+end
+
+function __oasr_config_keys
+    echo agent
+    echo profile
+    echo adapter.default
+    echo validation.strict
+    echo validation.show_references
+    echo oasr.completions
+end
+
+# Remove default completions
+complete -c oasr -e
+
+# Global options
+complete -c oasr -l help -s h -d "Show help"
+complete -c oasr -l version -d "Show version"
+complete -c oasr -l config -d "Config file path" -r
+complete -c oasr -l json -d "JSON output"
+complete -c oasr -l quiet -d "Suppress warnings"
+
+# Main commands
+complete -c oasr -f -n __fish_use_subcommand -a registry -d "Manage skill registry"
+complete -c oasr -f -n __fish_use_subcommand -a diff -d "Show tracked skill status"
+complete -c oasr -f -n __fish_use_subcommand -a sync -d "Refresh tracked skills"
+complete -c oasr -f -n __fish_use_subcommand -a config -d "Manage configuration"
+complete -c oasr -f -n __fish_use_subcommand -a clone -d "Clone skills to directory"
+complete -c oasr -f -n __fish_use_subcommand -a exec -d "Execute a skill"
+complete -c oasr -f -n __fish_use_subcommand -a use -d "DEPRECATED - use clone"
+complete -c oasr -f -n __fish_use_subcommand -a find -d "Find skills recursively"
+complete -c oasr -f -n __fish_use_subcommand -a validate -d "Validate skills"
+complete -c oasr -f -n __fish_use_subcommand -a clean -d "Clean up corrupted skills"
+complete -c oasr -f -n __fish_use_subcommand -a adapter -d "Generate IDE files"
+complete -c oasr -f -n __fish_use_subcommand -a update -d "Update OASR tool"
+complete -c oasr -f -n __fish_use_subcommand -a info -d "Show skill information"
+complete -c oasr -f -n __fish_use_subcommand -a help -d "Show help"
+complete -c oasr -f -n __fish_use_subcommand -a completion -d "Manage shell completions"
+
+# exec command
+complete -c oasr -f -n "__fish_seen_subcommand_from exec" -l agent -d "Agent to use" -a "(__oasr_agents)"
+complete -c oasr -f -n "__fish_seen_subcommand_from exec" -l profile -d "Policy profile" -a "(__oasr_profiles)"
+complete -c oasr -f -n "__fish_seen_subcommand_from exec" -l agent-flags -d "Additional agent flags"
+complete -c oasr -f -n "__fish_seen_subcommand_from exec" -s y -l yes -d "Skip confirmation"
+complete -c oasr -f -n "__fish_seen_subcommand_from exec" -l confirm -d "Force confirmation"
+complete -c oasr -f -n "__fish_seen_subcommand_from exec" -s p -l prompt -d "Prompt from file" -r
+complete -c oasr -f -n "__fish_seen_subcommand_from exec; and not __fish_seen_subcommand_from (__oasr_skills)" -a "(__oasr_skills)" -d "Skill"
+
+# clone command
+complete -c oasr -f -n "__fish_seen_subcommand_from clone" -s t -l target -d "Target directory" -r
+complete -c oasr -f -n "__fish_seen_subcommand_from clone; and not __fish_seen_subcommand_from (__oasr_skills)" -a "(__oasr_skills)" -d "Skill"
+
+# info command
+complete -c oasr -f -n "__fish_seen_subcommand_from info" -l files -d "Show file list"
+complete -c oasr -f -n "__fish_seen_subcommand_from info; and not __fish_seen_subcommand_from (__oasr_skills)" -a "(__oasr_skills)" -d "Skill"
+
+# validate command
+complete -c oasr -f -n "__fish_seen_subcommand_from validate; and not __fish_seen_subcommand_from (__oasr_skills)" -a "(__oasr_skills)" -d "Skill"
+
+# config subcommands
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from set get list path" -a "set" -d "Set configuration value"
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from set get list path" -a "get" -d "Get configuration value"
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from set get list path" -a "list" -d "List all configuration"
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from set get list path" -a "path" -d "Show config file path"
+
+# config set/get
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and __fish_seen_subcommand_from set get" -a "(__oasr_config_keys)" -d "Config key"
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and __fish_seen_subcommand_from set; and __fish_seen_subcommand_from agent" -a "(__oasr_agents)" -d "Agent"
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and __fish_seen_subcommand_from set; and __fish_seen_subcommand_from profile" -a "(__oasr_profiles)" -d "Profile"
+complete -c oasr -f -n "__fish_seen_subcommand_from config; and __fish_seen_subcommand_from set; and __fish_seen_subcommand_from validation.strict oasr.completions" -a "true false" -d "Boolean"
+
+# registry subcommands
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and not __fish_seen_subcommand_from add rm sync list validate prune" -a "add" -d "Add skill to registry"
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and not __fish_seen_subcommand_from add rm sync list validate prune" -a "rm" -d "Remove skill from registry"
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and not __fish_seen_subcommand_from add rm sync list validate prune" -a "sync" -d "Sync remote skills"
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and not __fish_seen_subcommand_from add rm sync list validate prune" -a "list" -d "List registry skills"
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and not __fish_seen_subcommand_from add rm sync list validate prune" -a "validate" -d "Validate registry"
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and not __fish_seen_subcommand_from add rm sync list validate prune" -a "prune" -d "Clean up registry"
+
+# registry rm
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and __fish_seen_subcommand_from rm" -a "(__oasr_skills)" -d "Skill"
+
+# registry prune
+complete -c oasr -f -n "__fish_seen_subcommand_from registry; and __fish_seen_subcommand_from prune" -l dry-run -d "Show what would be removed"
+
+# completion command
+complete -c oasr -f -n "__fish_seen_subcommand_from completion; and not __fish_seen_subcommand_from bash zsh fish powershell install uninstall" -a "bash" -d "Bash completion"
+complete -c oasr -f -n "__fish_seen_subcommand_from completion; and not __fish_seen_subcommand_from bash zsh fish powershell install uninstall" -a "zsh" -d "Zsh completion"
+complete -c oasr -f -n "__fish_seen_subcommand_from completion; and not __fish_seen_subcommand_from bash zsh fish powershell install uninstall" -a "fish" -d "Fish completion"
+complete -c oasr -f -n "__fish_seen_subcommand_from completion; and not __fish_seen_subcommand_from bash zsh fish powershell install uninstall" -a "powershell" -d "PowerShell completion"
+complete -c oasr -f -n "__fish_seen_subcommand_from completion; and not __fish_seen_subcommand_from bash zsh fish powershell install uninstall" -a "install" -d "Auto-detect and install"
+complete -c oasr -f -n "__fish_seen_subcommand_from completion; and not __fish_seen_subcommand_from bash zsh fish powershell install uninstall" -a "uninstall" -d "Remove completions"
+
+# completion flags
+complete -c oasr -f -n "__fish_seen_subcommand_from completion" -l force -d "Force reinstall"
+complete -c oasr -f -n "__fish_seen_subcommand_from completion" -l dry-run -d "Preview without installing"
+
+# adapter subcommands
+complete -c oasr -f -n "__fish_seen_subcommand_from adapter; and not __fish_seen_subcommand_from list generate" -a "list" -d "List adapters"
+complete -c oasr -f -n "__fish_seen_subcommand_from adapter; and not __fish_seen_subcommand_from list generate" -a "generate" -d "Generate adapter files"

completions/powershell.ps1

@@ -0,0 +1,115 @@
+# oasr completion for PowerShell
+# This file provides tab completion for the oasr command in PowerShell.
+#
+# Installation:
+#   Run: oasr completion install
+#   Or manually: Add this to your PowerShell profile ($PROFILE)
+
+# Helper functions for dynamic completion
+function Get-OasrSkills {
+    $skills = oasr registry list --quiet 2>$null | Select-String '^\s+-' | ForEach-Object {
+        $_.Line -replace '^\s+- ', '' -split ' ' | Select-Object -First 1
+    }
+    return $skills
+}
+
+function Get-OasrAgents {
+    return @('codex', 'copilot', 'claude', 'opencode')
+}
+
+function Get-OasrProfiles {
+    $profiles = oasr config list 2>$null | Select-String '^profiles\.' | ForEach-Object {
+        if ($_ -match '^profiles\.([^=]+)=') {
+            $matches[1]
+        }
+    } | Sort-Object -Unique
+    return $profiles
+}
+
+function Get-OasrConfigKeys {
+    return @(
+        'agent',
+        'profile',
+        'adapter.default',
+        'validation.strict',
+        'validation.show_references',
+        'oasr.completions'
+    )
+}
+
+# Main completion function
+$oasrCompletion = {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $command = $commandAst.CommandElements[0].Value
+    $elements = $commandAst.CommandElements
+    $elementCount = $elements.Count
+
+    # First argument - main commands
+    if ($elementCount -eq 2) {
+        $commands = @(
+            'registry', 'diff', 'sync', 'config', 'clone', 'exec', 'use',
+            'find', 'validate', 'clean', 'adapter', 'update', 'info',
+            'help', 'completion'
+        )
+        $commands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+        }
+        return
+    }
+
+    $subcommand = $elements[1].Value
+
+    switch ($subcommand) {
+        'exec' {
+            $prevWord = if ($elementCount -gt 2) { $elements[$elementCount - 2].Value } else { '' }
+            
+            switch ($prevWord) {
+                '--agent' {
+                    Get-OasrAgents | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Agent: $_")
+                    }
+                    return
+                }
+                '--profile' {
+                    Get-OasrProfiles | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Profile: $_")
+                    }
+                    return
+                }
+                default {
+                    if ($wordToComplete -like '-*') {
+                        @('--agent', '--profile', '--agent-flags', '-y', '--yes', '--confirm', '-p', '--prompt') |
+                            Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+                        }
+                    } else {
+                        Get-OasrSkills | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Skill: $_")
+                        }
+                    }
+                    return
+                }
+            }
+        }
+
+        'completion' {
+            if ($elementCount -eq 3) {
+                @('bash', 'zsh', 'fish', 'powershell', 'install', 'uninstall') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+                }
+                return
+            }
+
+            if ($wordToComplete -like '-*') {
+                @('--force', '--dry-run') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+                }
+            }
+            return
+        }
+    }
+}
+
+# Register the completion
+Register-ArgumentCompleter -Native -CommandName oasr -ScriptBlock $oasrCompletion

completions/zsh.sh

@@ -0,0 +1,259 @@
+#compdef oasr
+# oasr completion for zsh
+# This file provides tab completion for the oasr command in zsh.
+#
+# Installation:
+#   Run: oasr completion install
+#   Or manually: Add this file to your fpath and run compinit
+
+_oasr_skills() {
+    local skills
+    skills=(${(f)"$(oasr registry list --quiet 2>/dev/null | grep '^  -' | sed 's/^  - //' | awk '{print $1}')"})
+    _describe 'skill' skills
+}
+
+_oasr_agents() {
+    local agents
+    agents=(
+        'codex:OpenAI Codex agent'
+        'copilot:GitHub Copilot agent'
+        'claude:Anthropic Claude agent'
+        'opencode:OpenCode agent'
+    )
+    _describe 'agent' agents
+}
+
+_oasr_profiles() {
+    local profiles
+    profiles=(${(f)"$(oasr config list 2>/dev/null | grep '^profiles\.' | sed 's/^profiles\.\([^=]*\)=.*/\1/' | sort -u)"})
+    _describe 'profile' profiles
+}
+
+_oasr_config_keys() {
+    local keys
+    keys=(
+        'agent:Default agent'
+        'profile:Default policy profile'
+        'adapter.default:Default adapter target'
+        'validation.strict:Strict validation'
+        'validation.show_references:Show references'
+        'oasr.completions:Enable completions'
+    )
+    _describe 'config key' keys
+}
+
+_oasr_exec() {
+    _arguments \
+        '--agent[Agent to use]:agent:_oasr_agents' \
+        '--profile[Policy profile]:profile:_oasr_profiles' \
+        '--agent-flags[Additional agent flags]:flags:' \
+        '(-y --yes)'{-y,--yes}'[Skip confirmation]' \
+        '--confirm[Force confirmation]' \
+        '(-p --prompt)'{-p,--prompt}'[Prompt from file]:file:_files' \
+        '1:skill:_oasr_skills'
+}
+
+_oasr_clone() {
+    _arguments \
+        '(-t --target)'{-t,--target}'[Target directory]:directory:_directories' \
+        '*:skill:_oasr_skills'
+}
+
+_oasr_info() {
+    _arguments \
+        '--files[Show file list]' \
+        '1:skill:_oasr_skills'
+}
+
+_oasr_validate() {
+    _arguments \
+        '*:skill:_oasr_skills'
+}
+
+_oasr_config() {
+    local -a subcommands
+    subcommands=(
+        'set:Set a configuration value'
+        'get:Get a configuration value'
+        'list:List all configuration'
+        'path:Show config file path'
+    )
+
+    _arguments -C \
+        '1:subcommand:->subcommand' \
+        '*::arg:->args'
+
+    case $state in
+        subcommand)
+            _describe 'config subcommand' subcommands
+            ;;
+        args)
+            case ${words[1]} in
+                set)
+                    if [ ${#words[@]} -eq 2 ]; then
+                        _oasr_config_keys
+                    elif [ ${#words[@]} -eq 3 ]; then
+                        case ${words[2]} in
+                            agent)
+                                _oasr_agents
+                                ;;
+                            profile)
+                                _oasr_profiles
+                                ;;
+                            validation.strict|oasr.completions)
+                                _values 'boolean' true false
+                                ;;
+                        esac
+                    fi
+                    ;;
+                get)
+                    _oasr_config_keys
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_oasr_registry() {
+    local -a subcommands
+    subcommands=(
+        'add:Add skill to registry'
+        'rm:Remove skill from registry'
+        'sync:Sync remote skills'
+        'list:List registry skills'
+        'validate:Validate registry'
+        'prune:Clean up registry'
+    )
+
+    _arguments -C \
+        '1:subcommand:->subcommand' \
+        '*::arg:->args'
+
+    case $state in
+        subcommand)
+            _describe 'registry subcommand' subcommands
+            ;;
+        args)
+            case ${words[1]} in
+                add)
+                    _alternative \
+                        'directories:directory:_directories' \
+                        'urls:url:(http:// https:// git@)'
+                    ;;
+                rm)
+                    _oasr_skills
+                    ;;
+                prune)
+                    _arguments '--dry-run[Show what would be removed]'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_oasr_completion() {
+    local -a shells
+    shells=(
+        'bash:Bash completion'
+        'zsh:Zsh completion'
+        'fish:Fish completion'
+        'powershell:PowerShell completion'
+        'install:Auto-detect and install'
+        'uninstall:Remove completions'
+    )
+
+    _arguments \
+        '--force[Force reinstall]' \
+        '--dry-run[Preview without installing]' \
+        '1:shell:->shell'
+
+    case $state in
+        shell)
+            _describe 'shell' shells
+            ;;
+    esac
+}
+
+_oasr_adapter() {
+    local -a subcommands
+    subcommands=(
+        'list:List adapters'
+        'generate:Generate adapter files'
+    )
+
+    _arguments -C \
+        '1:subcommand:->subcommand' \
+        '*::arg:->args'
+
+    case $state in
+        subcommand)
+            _describe 'adapter subcommand' subcommands
+            ;;
+    esac
+}
+
+_oasr() {
+    local -a commands
+    commands=(
+        'registry:Manage skill registry'
+        'diff:Show tracked skill status'
+        'sync:Refresh tracked skills'
+        'config:Manage configuration'
+        'clone:Clone skills to directory'
+        'exec:Execute a skill'
+        'use:DEPRECATED - use clone instead'
+        'find:Find skills recursively'
+        'validate:Validate skills'
+        'clean:Clean up corrupted skills'
+        'adapter:Generate IDE-specific files'
+        'update:Update OASR tool'
+        'info:Show skill information'
+        'help:Show help'
+        'completion:Manage shell completions'
+    )
+
+    _arguments -C \
+        '(--help -h)'{--help,-h}'[Show help]' \
+        '--version[Show version]' \
+        '--config[Config file path]:file:_files' \
+        '--json[JSON output]' \
+        '--quiet[Suppress warnings]' \
+        '1:command:->command' \
+        '*::arg:->args'
+
+    case $state in
+        command)
+            _describe 'oasr command' commands
+            ;;
+        args)
+            case ${words[1]} in
+                exec)
+                    _oasr_exec
+                    ;;
+                clone)
+                    _oasr_clone
+                    ;;
+                info)
+                    _oasr_info
+                    ;;
+                validate)
+                    _oasr_validate
+                    ;;
+                config)
+                    _oasr_config
+                    ;;
+                registry)
+                    _oasr_registry
+                    ;;
+                completion)
+                    _oasr_completion
+                    ;;
+                adapter)
+                    _oasr_adapter
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_oasr "$@"

{oasr-0.5.1.dist-info → oasr-0.5.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oasr
-Version: 0.5.1
+Version: 0.5.2
 Summary: CLI for managing agent skills across IDE integrations
 Project-URL: Homepage, https://github.com/jgodau/asr
 Project-URL: Repository, https://github.com/jgodau/asr
@@ -317,6 +317,26 @@ Remote skills are fetched on-demand during `adapter` and `use` operations. The r
 
 ---
 
+## Shell Completions
+
+OASR supports intelligent tab completion for Bash, Zsh, Fish, and PowerShell:
+
+```bash
+# Install for your current shell
+oasr completion install
+
+# Now try it:
+oasr <TAB>          # Complete commands
+oasr info <TAB>     # Complete skill names
+oasr exec --<TAB>   # Complete flags
+```
+
+Completions are **dynamic** — skill names, agents, and profiles are fetched live from your registry.
+
+See [`oasr completion --help`](docs/commands/COMPLETION.md) for details.
+
+---
+
 ## Documentation
 
 - **[Quickstart](docs/QUICKSTART.md)** — Installation and first steps

{oasr-0.5.1.dist-info → oasr-0.5.2.dist-info}/RECORD

@@ -1,7 +1,7 @@
 __init__.py,sha256=cYuwXNht5J2GDPEbHz57rmXRyWzaUgAaCXz8okR0rKE,84
 __main__.py,sha256=Due_Us-4KNlLZhf8MkmoP1hWS5qMWmpZvz2ZaCqPHT4,120
 adapter.py,sha256=WEpYkKDTb7We0zU9i6Z-r5ydtUdghNhxTZ5Eq58h4fU,10027
-cli.py,sha256=xghN20mgfEeh3vR_Vaiv0i2f1MBN6gk8J0uU3kXRK8g,2672
+cli.py,sha256=LQg93XqUurMvcga2gV6sebv2RXGqfwDNvCN_UOLeTUc,2820
 discovery.py,sha256=WWF8SN2LH88mOUBJLavM7rvXcxi6uDQGpqRK20GysxA,3298
 manifest.py,sha256=feNCjkFWfhoVubevKjLtKoIEuzT1YGQn6wWgs9XM8_o,12229
 registry.py,sha256=zGutwVP39xaYqc3KDEXMWCV1tORYpqc5JISO8OaWP1Q,4470
@@ -27,6 +27,7 @@ commands/adapter.py,sha256=_68v3t-dRU0mszzL4udKs1bKennyg7RfBTaK2fDGTsE,3215
 commands/add.py,sha256=NJLQ-8-3zy7o6S9VLfL_wauP-Vz0oNGwN3nvtiwxNYM,15255
 commands/clean.py,sha256=RQBAfe6iCLsjMqUyVR55JdYX9MBqgrUuIrA8rFKs1J0,1102
 commands/clone.py,sha256=4APH34-yHjiXQIQwBnKOSEQ_sxV24_GKypcOJMfncvs,5912
+commands/completion.py,sha256=Y2KshaJ64vI1fcTR5z2KTJT7u9PPK_w8qMf5HK_q9ns,8570
 commands/config.py,sha256=4kzDEjVpwrmMPK_DPYePdQe2lGh_b8waYORZDHCDYZw,6976
 commands/diff.py,sha256=37JMjvfAEfvK7-4X5iFbD-IGkS8ae4YSY7ZDIZF5B9E,5766
 commands/exec.py,sha256=zFmxxclpHQF39sqDpR5436XQiEYo334BGcQ5a8gbR9I,8711
@@ -41,6 +42,11 @@ commands/sync.py,sha256=ZQoB5hBqrzvM6LUQVlKqHQVJib4dB5qe5M-pVG2vtGM,4946
 commands/update.py,sha256=bOWjdTNyeYg-hvXv5GfUzEtsTA7gU9JLM592GI9Oq68,11939
 commands/use.py,sha256=ggB28g2BDg3Lv3nF40wnDAJ7p0mo6C1pc1KgahvQYXM,1452
 commands/validate.py,sha256=Y8TLHxW4Z98onmzu-h-kDIET-48lVaIdQXOvuyBemLw,2361
+completions/__init__.py,sha256=cLGMHifEf91ElOIMSVffVWcifjGZ7oStb0Ot4ivLmmE,41
+completions/bash.sh,sha256=gqwuOqUDayPQ5_fHUtttJ_AK-Jef-vgSkUATbbtJBic,6169
+completions/fish.fish,sha256=LXUPp3Ad8aJ7j9m_xlX9Ej9H-3xLUhhMSzsB02oH8Vw,8042
+completions/powershell.ps1,sha256=dRtY-w8Hd3EmmJTtoDdkYzFN6tYiUtCeuu0pufUFsps,4210
+completions/zsh.sh,sha256=Pt-jfSHy8Q5kRtn314ejmP3_VCQGzcHAmK_buOKE4JI,6751
 config/__init__.py,sha256=glSjT1_y4aOfhZ8odrUWCGF1hBbY_huTjVp6suepHDY,3647
 config/defaults.py,sha256=JfCltQYoE7EqBYlxsNrSITLmwifTvRrJe5lqL0Ys7Cs,986
 config/env.py,sha256=WgnQXjhfvV7m1oxZCK9WdIX_rqLy_-BOSuPjbpjdI1c,7163
@@ -52,9 +58,9 @@ policy/profile.py,sha256=WDKaUagsWnBPGz5a_OOcxTsdZ66WjaIaR0R7ITVqy8g,6790
 skillcopy/__init__.py,sha256=YUglUkDzKfnCt4ar_DU33ksI9fGyn2UYbV7qn2c_BcU,2322
 skillcopy/local.py,sha256=QH6484dCenjg8pfNOyTRbQQBklEWhkkTnfQok5ssf_4,1049
 skillcopy/remote.py,sha256=83jRA2VfjtSDGO-YM1x3WGJjKvWzK1RmSTL7SdUOz8s,3155
-oasr-0.5.1.dist-info/METADATA,sha256=fAfdWjbFnZGfRpQ7gJx1IgpKLbaXgpFZz6ddjdzumxc,17924
-oasr-0.5.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-oasr-0.5.1.dist-info/entry_points.txt,sha256=VnMuOi6XYMbzAD2bP0X5uV1sQXjOqoDWJ33Lsxwq8u8,52
-oasr-0.5.1.dist-info/licenses/LICENSE,sha256=nQ1j9Ldb8FlJ-z7y2WuXPIlyfnYC7YPasjGdOBgcfP4,10561
-oasr-0.5.1.dist-info/licenses/NOTICE,sha256=EsfkCN0ZRDS0oj3ADvMKeKrAXaPlC8YfpSjvjGVv9jE,207
-oasr-0.5.1.dist-info/RECORD,,
+oasr-0.5.2.dist-info/METADATA,sha256=SQ26Gtaa3LH-7f5CSHfM1yLUzNmizhYEuWO9lqTqSVM,18413
+oasr-0.5.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+oasr-0.5.2.dist-info/entry_points.txt,sha256=VnMuOi6XYMbzAD2bP0X5uV1sQXjOqoDWJ33Lsxwq8u8,52
+oasr-0.5.2.dist-info/licenses/LICENSE,sha256=nQ1j9Ldb8FlJ-z7y2WuXPIlyfnYC7YPasjGdOBgcfP4,10561
+oasr-0.5.2.dist-info/licenses/NOTICE,sha256=EsfkCN0ZRDS0oj3ADvMKeKrAXaPlC8YfpSjvjGVv9jE,207
+oasr-0.5.2.dist-info/RECORD,,