@prestyj/boss 4.3.160

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KenKai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,168 @@
+![ezboss](screenshots/ezboss.png)
+
+<p align="center">
+  <strong>One chat. Many ezcoder workers. The boss runs the room.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@prestyj/boss"><img src="https://img.shields.io/npm/v/@prestyj/boss?style=for-the-badge" alt="npm version"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://youtube.com/@kenkaidoesai"><img src="https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white" alt="YouTube"></a>
+  <a href="https://skool.com/kenkai"><img src="https://img.shields.io/badge/Skool-Community-7C3AED?style=for-the-badge" alt="Skool"></a>
+  <a href="https://github.com/KenKaiii"><img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a>
+</p>
+
+You talk to the boss. The boss drives the workers — one per project — in parallel. Dispatch work, watch them finish, keep a backlog, swap models on the fly. All from one terminal.
+
+Built on [`@prestyj/cli`](../ezcoder/README.md), [`@prestyj/agent`](../agent/README.md) and [`@prestyj/ai`](../ai/README.md). Part of the [EZCoder Framework](../../README.md) monorepo.
+
+---
+
+## 🚀 Run It
+
+```bash
+# Sign in once with ezcoder — ezboss reuses the same auth
+npm i -g @prestyj/cli
+ezcoder login
+
+# Install the boss
+npm i -g @prestyj/boss
+
+# Pick which projects the boss should drive (interactive picker —
+# scans your ezcoder, Claude Code, and Codex session history)
+ezboss link
+
+# Start the orchestrator
+ezboss
+```
+
+Already linked? `ezboss continue` resumes the most recent session. `ezboss --resume <id>` resumes a specific one.
+
+---
+
+## 🪄 How it works
+
+You type one prompt. The boss decides which workers to dispatch, in parallel or serial, with `prompt_worker` (fire-and-forget) or by adding to the task plan and calling `dispatch_pending`. Each worker is a full `ezcoder` agent — read, write, edit, bash, grep, find, ls, web fetch, sub-agents — running in its own project directory.
+
+When a worker finishes, you get a tight summary back: **Changed**, **Skipped**, **Verified**, **Notes**, and a single-letter **Status** (`DONE` / `UNVERIFIED` / `PARTIAL` / `BLOCKED` / `INFO`). The boss reads that, cross-checks it against the worker's actual tool calls, and either reports back to you or re-prompts to verify, finish, or unblock.
+
+A few things make it feel like one conversation instead of N:
+
+- **Live worker state** is appended to every event the boss receives. It can never forget that "B is still working" while it's reading "A finished".
+- **Auto-chain.** If the boss leaves a project parked while pending tasks remain, the orchestrator dispatches the next task itself and tells the boss it did so.
+- **Auto-compact.** When the boss's context crosses 80%, it compacts and starts a fresh session file so `ezboss continue` resumes the trimmed history.
+- **Crash-resistant.** Six workers in one process can't take the boss down — uncaught throws and unhandled rejections are logged to `~/.ezcoder/boss/debug.log` and the run loop keeps going.
+- **Audio chimes.** A done sound on each worker finish, an all-clear chime when every worker is idle and the queue is empty.
+
+---
+
+## 🎛 Models
+
+Boss and workers run on **different models, on purpose**. Use a strong reasoning model (Opus, GPT-5) up top and a fast cheap model (Sonnet, Haiku) for the workers — or whatever combination fits the work.
+
+Defaults: `claude-opus-4-7` for the boss, `claude-sonnet-4-6` for the workers. Anthropic, OpenAI, GLM, and Moonshot are all supported (anything `ezcoder` supports). Swap mid-session with `/model-boss` and `/model-workers` — your choice persists across restarts.
+
+```bash
+ezboss --boss-model claude-opus-4-7 --worker-model claude-sonnet-4-6
+ezboss --project ../api --project ../web   # explicit project list
+```
+
+---
+
+## ⌨️ Keybindings
+
+| Key | What it does |
+|---|---|
+| <kbd>Tab</kbd> | Cycle the project scope pill (All / per-project) on your next message |
+| <kbd>Shift+Tab</kbd> | Toggle the boss's extended thinking |
+| <kbd>Esc</kbd> | Interrupt the boss mid-turn (workers keep running) |
+| <kbd>Ctrl+T</kbd> | Open the Tasks pane |
+| <kbd>Ctrl+C</kbd> ×2 | Exit ezboss |
+| <kbd>↑</kbd> / <kbd>↓</kbd> | Recall previous prompts (when input is empty) |
+| <kbd>Enter</kbd> | Send · <kbd>Shift+Enter</kbd> newline · `/` opens the slash menu |
+
+Inside the **Tasks pane** (<kbd>Ctrl+T</kbd>):
+
+| Key | What it does |
+|---|---|
+| <kbd>↑</kbd> / <kbd>↓</kbd> (or <kbd>k</kbd> / <kbd>j</kbd>) | Navigate tasks |
+| <kbd>Enter</kbd> | Dispatch the selected task to its worker |
+| <kbd>r</kbd> | Run all pending and blocked tasks across idle workers |
+| <kbd>d</kbd> | Delete the selected task |
+| <kbd>Esc</kbd> | Close the pane |
+
+---
+
+## 💬 Slash commands
+
+| Command | What it does |
+|---|---|
+| `/help` (`/?`) | Show all commands and keybindings |
+| `/model-boss` | Switch the orchestrator's model |
+| `/model-workers` | Switch every worker's model |
+| `/compact` | Compact the boss's context now |
+| `/clear` | Clear chat history and terminal |
+| `/radio` | Stream a free internet radio station while you work |
+| `/quit` (`/q`, `/exit`) | Exit ezboss |
+
+---
+
+## 📋 The task plan
+
+The boss isn't just a dispatcher — it keeps a persistent backlog. Use it for tracked, reviewable, resumable work.
+
+- The boss adds tasks via `add_task(project, title, description, fresh?)`.
+- Tasks live in `~/.ezcoder/boss/tasks.json` and survive restarts.
+- Press <kbd>Ctrl+T</kbd> any time to see the plan, dispatch an item, or delete it.
+- Worker self-reported status (`DONE` / `UNVERIFIED` / `PARTIAL` / `BLOCKED` / `INFO`) auto-updates the task, with the boss free to override based on cross-check.
+- When a project goes idle with pending work in the plan, **auto-chain** picks up the next task without the boss having to remember.
+
+Direct dispatch (`prompt_worker`) is for one-shot work. The plan is for batches you want to curate, review, and resume.
+
+---
+
+## 📻 Radio
+
+`/radio` streams long-running, royalty-free internet radio while you work — SomaFM Groove Salad, Drone Zone, Radio Paradise Mellow Mix, lofi beats. Pick a station or `Off`. Requires one of `mpv` (recommended), `ffplay`, `mpg123`, or `vlc/cvlc` on your `PATH`.
+
+---
+
+## 🗂 Project discovery
+
+`ezboss link` is interactive. It scans:
+
+- `~/.ezcoder/sessions/` — your existing **ezcoder** projects
+- `~/.claude/projects/` — your **Claude Code** projects (cwds extracted from the JSONL events themselves, not the lossy dir-name encoding)
+- `~/.codex/sessions/` — your **Codex** projects (cwds pulled from session metadata)
+
+Sorted most-recent first. Pick a few, save the list, and the boss starts a worker for each one.
+
+---
+
+## 🛟 Auto-update
+
+On every launch the boss installs any pending update from the prior run (effective next launch) and schedules a fresh registry check in the background. No prompts, no interruption — you just stay current.
+
+---
+
+## 👥 Community
+
+- [YouTube @kenkaidoesai](https://youtube.com/@kenkaidoesai) — tutorials and demos
+- [Skool community](https://skool.com/kenkai) — come hang out
+- [GitHub @KenKaiii](https://github.com/KenKaiii)
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+<p align="center">
+  <strong>Talk to the boss. The workers do the rest.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@prestyj/boss"><img src="https://img.shields.io/badge/Install-npm%20i%20--g%20%40Gahroot%2Fgg--boss-blue?style=for-the-badge" alt="Install"></a>
+</p>