https://github.com/fabkho/pi-solo
Pi extensions for Soloterm — agent orchestration, dispatch, and fork workflows
https://github.com/fabkho/pi-solo
extension pi solo soloterm
Last synced: about 14 hours ago
JSON representation
Pi extensions for Soloterm — agent orchestration, dispatch, and fork workflows
- Host: GitHub
- URL: https://github.com/fabkho/pi-solo
- Owner: fabkho
- Created: 2026-05-20T10:16:51.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-05-20T11:35:04.000Z (26 days ago)
- Last Synced: 2026-05-20T15:53:22.843Z (26 days ago)
- Topics: extension, pi, solo, soloterm
- Language: TypeScript
- Homepage:
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# pi-solo
Pi extensions for [Soloterm](https://soloterm.com) — agent orchestration, parallel dispatch, and fork workflows.
## Commands
### `/fork-solo`
Fork the current session at a selected message and open it as a new Pi agent in Soloterm. The current session stays intact.
```
/fork-solo — show message selector, fork in new Solo agent
/fork-solo — fork + pre-fill initial prompt
```
### `/dispatch`
Spawn a Pi worker agent in Soloterm with a focused task. Quick and simple.
```
/dispatch Fix the login form validation in src/components/LoginForm.vue
/dispatch Write unit tests for the payment service
```
### `/orchestrate`
Plan parallel work and dispatch multiple Solo worker agents. Parses multi-line goals into independent lanes.
```
/orchestrate
- Refactor auth middleware to use JWT refresh tokens
- Add rate limiting to /api/bookings endpoint
- Write E2E tests for the booking flow
```
## LLM Tool
### `dispatch_solo_worker`
The LLM can call this tool directly to spawn parallel workers when it identifies independent work lanes. Useful during planning conversations — the model can dispatch workers as it breaks down the problem.
## Requirements
- [Soloterm](https://soloterm.com) running with Pi configured as an agent tool
- Must be running inside Solo (needs `SOLO_PROJECT_ID` env var)
- Pi agent tool must be enabled in Solo Settings → Agents
## Install
```bash
pi install npm:pi-solo
```
Or load locally:
```bash
# In settings.json packages array:
"/path/to/pi-solo"
```
## How it works
- Uses `solo-cli` (bundled in Solo.app) to spawn agent processes
- Auto-discovers Pi's agent tool ID on first use
- Workers appear in Solo's Agents sidebar section with clear labels
- Each worker runs independently with its own conversation
## License
MIT