packages/coding-agent/docs/shell-aliases.md

Shell Aliases

Pi runs bash in non-interactive mode (bash -c), which doesn't expand aliases by default.

To enable your shell aliases, add to ~/.pi/agent/settings.json:

{
  "shellCommandPrefix": "shopt -s expand_aliases\neval \"$(grep '^alias ' ~/.zshrc)\""
}

Adjust the path (~/.zshrc, ~/.bashrc, etc.) to match your shell config.