Run Pi through paper so the session is captured. Prerequisites: paperctl installed and authenticated.
Start
paperctl start pi
Like Claude Code, Pi is a single step: paperctl start pi launches it through the local proxy so the session is captured to paper console. Use Pi normally from there.
Anything after -- is passed straight through to Pi:
paperctl start pi -- <pi-flags>
Verify the capture
paperctl sessions list
The session appears at the top with its turn count, cost, and status, and shows up in paper console moments later.
If something’s off
- No session in the list: check
paperctl statusandpaperctl logs. - More cases: CLI troubleshooting.