Skip to main content

completion

Generate shell completion scripts for bash, zsh, and fish
Generate shell completion scripts to enable tab completion for App Store Connect CLI commands.

Quick Start

Usage

Flags:
  • --shell - Shell type: bash, zsh, or fish (required)

Supported Shells

Bash

Generate and load bash completion:
Or append directly:

Zsh

Generate and load zsh completion:
Or append directly:

Fish

Generate and install fish completion:

How It Works

The completion script provides tab completion for:
  • Top-level commands (e.g., builds, testflight, metadata)
  • Common flags (basic support)
Example:

Manual Installation

Bash (Linux)

Bash (macOS with Homebrew)

Zsh (with Oh My Zsh)

Zsh (macOS with Homebrew)

Verification

Test that completion is working:
If completion doesn’t work:
  1. Verify the script was added to the correct location
  2. Reload your shell configuration
  3. Check for syntax errors in the completion script

Troubleshooting

Bash: Command not found

Ensure bash-completion is installed:

Zsh: Completion not loading

Ensure completion is enabled in .zshrc:

Fish: Permission denied

Ensure the completions directory exists and is writable:

Advanced Configuration

Custom Completion Location

Save completion to a custom location:

Conditional Loading

Load completion only when asc is available:

CI/CD Integration

Generate completion in Docker containers:

Updates

Regenerate completion after upgrading the CLI: