Skip to main content
The completion command generates shell completion scripts that enable tab-completion for Codex commands, subcommands, and flags.

​
Usage

codex completion [SHELL]

​
Supported Shells

  • bash (default)
  • zsh
  • fish
  • powershell
  • elvish

​
Installation

​
Bash

Add to your ~/.bashrc: 
eval "$(codex completion bash)"
Or generate to a file: 
codex completion bash > ~/.local/share/bash-completion/completions/codex

​
Zsh

Add to your ~/.zshrc: 
eval "$(codex completion zsh)"
Or generate to a file: 
codex completion zsh > ~/.zsh/completions/_codex
Make sure ~/.zsh/completions is in your $fpath: 
fpath=(~/.zsh/completions $fpath)

​
Fish

Generate to Fish’s completions directory: 
codex completion fish > ~/.config/fish/completions/codex.fish

​
PowerShell

Add to your PowerShell profile: 
codex completion powershell | Out-String | Invoke-Expression

​
Examples

​
Generate Bash Completions

codex completion bash

​
Generate for Specific Shell

codex completion zsh
codex completion fish

​
Save to File

codex completion bash > /usr/local/etc/bash_completion.d/codex

​
What Gets Completed

Shell completion works for:
  • Commands: codex <TAB> shows all available commands
  • Subcommands: codex mcp <TAB> shows MCP subcommands
  • Flags: codex --<TAB> shows all global flags
  • Options: codex -m <TAB> suggests model names

​
Troubleshooting

​
Completions Not Working

  1. Make sure you’ve reloaded your shell: 
    exec $SHELL
  2. Verify the completion file is in the right location: 
    # Bash
echo $BASH_COMPLETION_USER_DIR

# Zsh
echo $fpath
  3. Check that the completion function is loaded: 
    # Bash
complete -p codex

# Zsh
which _codex

codex

Main Codex CLI command