# OpenCLI Agent Pack: pi-swarm-supervisor

Use this when an AI agent needs to work with `pi-swarm`.

## What this CLI is for
Spawn isolated Pi side agents, detect stuck workers, and apply analyzer suggestions from the terminal. Built by Geet Khosla. Start with `pi install npm:pi-swarm-supervisor` and go from there. Runs entirely on your machine.

Best for: Supervising several Pi coding agents from one dashboard.

## Agent readiness
Human-first CLI (20/100)
- Can run locally with less credential exposure.

## Install
```sh
pi install npm:pi-swarm-supervisor
```

## Verify before real work
```sh
pi-swarm --help
```
Expected signal: pi-swarm responds locally; authenticate before real work.

## Safe starting commands
```sh
pi-swarm --help
```

```sh
/swarm-roles
```

```sh
pi install npm:pi-swarm-supervisor
```

```sh
/swarm-start scout :: inspect this repo
```

```sh
/swarm
```

## Guardrails for agents
- Prefer small commands and ask the agent to summarize plain text output.
- Expect prompts; keep a human in the loop for interactive flows.
- Verify identity/account before running task commands.
- Network access is required; avoid leaking secrets in logs.
- Start read-only, then ask before mutations.

## Suggested agent instruction
You may use pi-swarm-supervisor (`pi-swarm`) for supervising several pi coding agents from one dashboard.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.

Source: OpenCLI