@codexstar/pi-side-chat
v1.0.2
Published
Standalone side chat for Pi CLI — parallel AI agent with read-only tools
Maintainers
Readme
What is this?
A floating AI chat panel that runs alongside your main Pi coding agent. Open it with Alt+/ and ask questions about what the agent is doing, get a session recap, check if the agent is stuck, or just chat.
- Parallel AI instance — does not interrupt your main agent
- Read-only tools only — safe inspection, no accidental file edits
peek_maintool — lets the side chat see what the main agent is working on- Built-in shortcuts — type
analyze,stuck,recap,status, orhelp - Per-session conversations — each new session starts fresh
Install
pi install @codexstar/pi-side-chatUsage
| Action | How |
|--------|-----|
| Open/toggle chat | Alt+/ or /sidechat |
| Send message | Type + Enter |
| Close | Esc |
| Unfocus (back to main) | Alt+/ again |
| Open settings | /sidechat-settings |
Settings
Run /sidechat-settings to configure:
- Model — pick any available model or use the session default
- Width/Height — adjust the overlay size
- Enable/Disable — toggle the extension
Settings persist to ~/.pi/side-chat/config.json.
Requirements
- Pi CLI with extension support
- Node.js >= 18.17
License
MIT
