Open Codex app from the macOS Terminal with the Current Project Selected

👋 Need help with code?

Open Codex app from the macOS Terminal with the Current Project Selected | TechForDev

I wanted a quick way to open Codex app directly from the macOS terminal with the current project folder already selected.

Add the following function to your local Zsh config file, such as ~/.zshrc. It opens a new Codex thread using the current directory as the workspace. You can also pass a directory path as an argument.

This assumes Codex app is installed on macOS. It uses python3 only to URL-encode the local path safely.

# Open Codex app with the current directory as a new thread workspace.
# Usage:
#   cdxnew
#   cdxnew .
#   cdxnew ~/your/project
#   cdxnew ../other-project
cdxnew() {
  local target="${1:-$PWD}"

  if [ ! -d "$target" ]; then
    echo "cdxnew: directory not found: $target" >&2
    return 1
  fi

  local abs_path
  abs_path="$(cd "$target" && pwd)"

  local encoded
  encoded="$(CODEX_PATH="$abs_path" python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["CODEX_PATH"]))')"

  open "codex://new?path=$encoded"
}