pi-boss

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #golang #go #android #machine-learning #windows #cli #vue #pytorch #security #ios #open-source

(★ 11)

Spawn and manage sub-agents in visible tmux panes — the orchestrator that makes multi-agent boss mode work for pi coding agent.

pi-boss Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/skyfallsin/pi-boss/main/LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/skyfallsin/pi-boss)](https://github.com/skyfallsin/pi-boss/stargazers)

# pi-boss

Spawn and manage sub-agents in visible tmux panes for [pi](https://github.com/badlogic/pi-mono). The orchestrator that makes boss mode work.

## What it does

Say "boss mode" and the agent breaks your task into subtasks, spawns parallel agents in tmux split panes, monitors their progress, and steers them as needed. Each spawned agent gets its own pi instance with a self-contained task.

## Tools

### `spawn`

Four actions:

**create** — Split the view and spawn a new pi agent with a task:
```
spawn(action: "create", task: "fix the auth bug in src/login.ts", name: "auth-fix")
spawn(action: "create", task: "write tests for the API", cwd: "/path/to/project")
```

**list** — Show all spawned agents and whether they're alive:
```
spawn(action: "list")
```

**highlight** — Color a pane to signal status:
```
spawn(action: "highlight", pane: "12", color: "green")   # done
spawn(action: "highlight", pane: "12", color: "red")      # needs attention
spawn(action: "highlight", pane: "12", color: "default")  # clear
```

**kill** — Kill a spawned agent's pane:
```
spawn(action: "kill", pane: "12")
```

## Boss mode

The extension injects a "Boss Mode" instruction into the system prompt. When you say "boss mode", the agent:

1. Breaks the task into independent subtasks
2. Spawns agents in parallel (one per subtask)
3. Enters a monitoring loop: sleep → peek all → steer/kill ready ones → repeat
4. Reports back when all agents are done

Spawned agents auto-register in the room (via [pi-room](https://github.com/skyfallsin/pi-room)), so the boss can use `peek` and `steer` to interact with them.

## Install

```bash
pi install git:github.com/skyfallsin/pi-boss
```

Or clone:

```bash
git clone https://github.com/skyfallsin/pi-boss ~/.pi/agent/extensions/pi-boss
```

**Requires [pi-room](https://github.com/skyfallsin/pi-room)** for peek/steer. Install both:

```bash
pi install git:github.com/skyfallsin/pi-room
pi install git:github.com/skyfallsin/pi-boss
```

## Requirements

- [pi](https://github.com/badlogic/pi-mono)
- [pi-room](https://github.com/skyfallsin/pi-room) (for peek/steer tools)
- tmux

## How it works

- On first spawn, enables tmux pane borders and labels the boss pane
- Splits the window horizontally and runs `pi <task>` in the new pane
- Auto-tiles panes after each spawn/kill for a clean layout
- Spawned agents get `PI_SPAWNED=1` and `PI_PARENT_PANE` env vars so they know they're children
- Session files of spawned agents link back to the boss session via `parentSession`
- On shutdown, all spawned panes are killed and borders are reset

## License

MIT

## Pi Ecosystem

| Package | Description |
|---------|-------------|
| [pi-mem](https://github.com/jo-inc/pi-mem) | Persistent markdown memory for coding agents |
| [pi-reflect](https://github.com/jo-inc/pi-reflect) | Self-improving behavioral files |
| [pi-room](https://github.com/skyfallsin/pi-room) | Multi-agent awareness and coordination |
| [pi-vertex-anthropic](https://github.com/skyfallsin/pi-vertex-anthropic) | Claude via Google Cloud Vertex AI |
| [pi-skill-posthog](https://github.com/skyfallsin/pi-skill-posthog) | PostHog analytics skill for pi agents |

pi-boss

pi-boss Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

pi-boss

pi-boss Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README