Skip to content

Pi ​

Prerequisites ​

  1. Node.js 22.23.4+ or 24.22.1+
  2. Pi (npm install -g @earendil-works/pi-coding-agent) installed and configured

Install & Run ​

bash
# Install daemon
npm install -g @cmdctrl/pi

# Register
cmdctrl-pi register -s https://api.cmd-ctrl.ai

# Start
cmdctrl-pi start

How It Works ​

Cmd+Ctrl's pi daemon spawns the pi CLI once per task and reads message history directly from pi's native session store at ~/.pi/agent/sessions/. Sessions started through Cmd+Ctrl are fully interoperable with the pi CLI – you can pi --resume a session that was created via Cmd+Ctrl and continue it in your terminal, and vice versa.

Override the pi binary location with PI_BIN=/path/to/pi if needed.

oh-my-pi (omp) ​

oh-my-pi has its own daemon, @cmdctrl/omp, so one machine can run both. See oh-my-pi.

Troubleshooting ​

"pi not found" – Ensure pi is in your PATH: which pi. If you installed via a tool like volta or fnm, you may need to set PI_BIN=/absolute/path/to/pi.