PiPi
Quickstart
Using Pi
  • 简体中文
  • English
Quickstart
Using Pi
  • 简体中文
  • English
  • Start here

    • Quickstart
    • Using Pi
    • Providers
    • Security
    • Containerization
    • Settings
    • Keybindings
    • Sessions
    • Compaction & Branch Summarization
  • Customization

    • Extensions
    • Skills
    • Prompt Templates
    • Themes
    • Pi Packages
    • Custom Models
    • Custom Providers
  • Reference

    • Session File Format
  • Programmatic Usage

    • SDK
    • RPC Mode
    • JSON Event Stream Mode
    • TUI Components
  • Platform Setup

    • Windows Setup
    • Termux (Android) Setup
    • tmux Setup
    • Terminal Setup
    • Shell Aliases
  • Development

    • Development

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.

Last Updated:: 7/6/26, 9:32 AM
Contributors: seepine
Prev
Terminal Setup