PI Mode
PI mode is a persistent assistant session bound to the active repository.
Layout
Section titled “Layout”The focus ring wraps:
- message history
- tool blocks
- input
The footer is anchored outside that ring and always visible.
Message types
Section titled “Message types”- User: muted
>prefixed turns. - Assistant: markdown-aware rendered output.
- Tool: status-colored execution blocks.
Input and streaming
Section titled “Input and streaming”| Key | Action |
|---|---|
enter | Send input |
esc | Abort stream (if active) or soft-pause (idle) |
G | Jump to bottom |
Streaming behavior:
- Auto-scrolls on new deltas.
- Pauses auto-scroll when you manually scroll up.
- Keeps context visible while tools run.
Session lifecycle
Section titled “Session lifecycle”- One session per repo context.
- Session survives mode switches.
- Session ends only on
/exit, repo change, or app quit.
Mode handoffs
Section titled “Mode handoffs”ctrl+d-> DIFFctrl+g-> GITiresumes PI from other modes
Footer states
Section titled “Footer states”| State | Meaning |
|---|---|
| idle | Ready for input |
| streaming | Receiving text deltas |
| tool running | Tool execution in progress |
| compacting | Automatic context compaction active |
| scrolled up | Auto-follow disabled until jump |
| cmd prefix | Waiting for PI command chord |
Spinner style uses a calm braille animation during active PI work.