{"id":50233108,"url":"https://github.com/skyfallsin/pi-boss","last_synced_at":"2026-07-17T15:01:31.149Z","repository":{"id":353849485,"uuid":"1188900120","full_name":"skyfallsin/pi-boss","owner":"skyfallsin","description":"Spawn and manage sub-agents in visible tmux panes — the orchestrator that makes multi-agent boss mode work for pi coding agent.","archived":false,"fork":false,"pushed_at":"2026-04-25T20:50:33.000Z","size":7,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-25T22:28:48.270Z","etag":null,"topics":["ai-agent","boss-mode","multi-agent","orchestration","parallel-agents","pi-coding-agent","sub-agent","tmux","typescript"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@jo-inc/pi-boss","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skyfallsin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-22T18:25:45.000Z","updated_at":"2026-04-25T20:50:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/skyfallsin/pi-boss","commit_stats":null,"previous_names":["skyfallsin/pi-boss"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/skyfallsin/pi-boss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyfallsin%2Fpi-boss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyfallsin%2Fpi-boss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyfallsin%2Fpi-boss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyfallsin%2Fpi-boss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skyfallsin","download_url":"https://codeload.github.com/skyfallsin/pi-boss/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyfallsin%2Fpi-boss/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35585716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-17T02:00:06.162Z","response_time":116,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","boss-mode","multi-agent","orchestration","parallel-agents","pi-coding-agent","sub-agent","tmux","typescript"],"created_at":"2026-05-26T19:00:32.257Z","updated_at":"2026-07-17T15:01:31.126Z","avatar_url":"https://github.com/skyfallsin.png","language":"TypeScript","funding_links":[],"categories":["Extensions","Harnesses \u0026 orchestration"],"sub_categories":["Session managers \u0026 parallel runners"],"readme":"[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/skyfallsin/pi-boss)](https://github.com/skyfallsin/pi-boss/stargazers)\n\n# pi-boss\n\nSpawn and manage sub-agents in visible tmux panes for [pi](https://github.com/badlogic/pi-mono). The orchestrator that makes boss mode work.\n\n## What it does\n\nSay \"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.\n\n## Tools\n\n### `spawn`\n\nFour actions:\n\n**create** — Split the view and spawn a new pi agent with a task:\n```\nspawn(action: \"create\", task: \"fix the auth bug in src/login.ts\", name: \"auth-fix\")\nspawn(action: \"create\", task: \"write tests for the API\", cwd: \"/path/to/project\")\n```\n\n**list** — Show all spawned agents and whether they're alive:\n```\nspawn(action: \"list\")\n```\n\n**highlight** — Color a pane to signal status:\n```\nspawn(action: \"highlight\", pane: \"12\", color: \"green\")   # done\nspawn(action: \"highlight\", pane: \"12\", color: \"red\")      # needs attention\nspawn(action: \"highlight\", pane: \"12\", color: \"default\")  # clear\n```\n\n**kill** — Kill a spawned agent's pane:\n```\nspawn(action: \"kill\", pane: \"12\")\n```\n\n## Boss mode\n\nThe extension injects a \"Boss Mode\" instruction into the system prompt. When you say \"boss mode\", the agent:\n\n1. Breaks the task into independent subtasks\n2. Spawns agents in parallel (one per subtask)\n3. Enters a monitoring loop: sleep → peek all → steer/kill ready ones → repeat\n4. Reports back when all agents are done\n\nSpawned 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.\n\n## Install\n\n```bash\npi install git:github.com/skyfallsin/pi-boss\n```\n\nOr clone:\n\n```bash\ngit clone https://github.com/skyfallsin/pi-boss ~/.pi/agent/extensions/pi-boss\n```\n\n**Requires [pi-room](https://github.com/skyfallsin/pi-room)** for peek/steer. Install both:\n\n```bash\npi install git:github.com/skyfallsin/pi-room\npi install git:github.com/skyfallsin/pi-boss\n```\n\n## Requirements\n\n- [pi](https://github.com/badlogic/pi-mono)\n- [pi-room](https://github.com/skyfallsin/pi-room) (for peek/steer tools)\n- tmux\n\n## How it works\n\n- On first spawn, enables tmux pane borders and labels the boss pane\n- Splits the window horizontally and runs `pi \u003ctask\u003e` in the new pane\n- Auto-tiles panes after each spawn/kill for a clean layout\n- Spawned agents get `PI_SPAWNED=1` and `PI_PARENT_PANE` env vars so they know they're children\n- Session files of spawned agents link back to the boss session via `parentSession`\n- On shutdown, all spawned panes are killed and borders are reset\n\n## License\n\nMIT\n\n## Pi Ecosystem\n\n| Package | Description |\n|---------|-------------|\n| [pi-mem](https://github.com/jo-inc/pi-mem) | Persistent markdown memory for coding agents |\n| [pi-reflect](https://github.com/jo-inc/pi-reflect) | Self-improving behavioral files |\n| [pi-room](https://github.com/skyfallsin/pi-room) | Multi-agent awareness and coordination |\n| [pi-vertex-anthropic](https://github.com/skyfallsin/pi-vertex-anthropic) | Claude via Google Cloud Vertex AI |\n| [pi-skill-posthog](https://github.com/skyfallsin/pi-skill-posthog) | PostHog analytics skill for pi agents |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskyfallsin%2Fpi-boss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskyfallsin%2Fpi-boss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskyfallsin%2Fpi-boss/lists"}