git404hub

what is pi-fleet fr?

kellykampen/pi-fleet — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5Setup · moderate

tl;dr

A command line system that turns the Pi coding agent into a team of restricted, single purpose AI agents like implementer, reviewer, and researcher.

vibe map

mindmap
  root((pi-fleet))
    What it does
      Restricted agent seats
      Enforced tool limits
      Parallel agent teams
    Tech stack
      TypeScript
      Node.js
      Pi agent
    Use cases
      Read only review
      Parallel implementation
      Project routing
    Audience
      Developers
      AI power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a read-only reviewer agent that has no ability to edit files or run shell commands.

VIBE 2

Coordinate multiple AI coding agents working on different parts of the same project in parallel.

VIBE 3

Give a project lead agent the power to cast worker agents and merge their finished pull requests.

what's the stack?

TypeScriptNode.js

how it stacks up fr

kellykampen/pi-fleet0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires the Pi coding agent, Node.js 20+, and at least one authenticated AI provider.

in plain english

pi-fleet is a command line tool for running a small team of restricted, single purpose AI coding agents built on top of the Pi coding agent. Instead of one general purpose assistant, it gives each role, such as implementer, reviewer, researcher, or designer, its own reusable agent seat with a default model, a defined skill, and a list of tools it is allowed to use. A reviewer seat, for example, has no ability to write, edit, or run shell commands at all, while a builder seat does, and that restriction is enforced by the tool rather than just suggested in a prompt. These seats are organized into a small hierarchy: a human still sets goals and priorities, a conductor agent routes work across projects, project leads own a single project and cast worker agents to do the actual implementation, review, or research, and each worker reports back up the chain. This structure lets several agents work on different parts of a project at the same time, each running in its own terminal pane, while keeping real limits on what any one of them can touch. The project does not reimplement any of this from scratch. It combines three existing packages: one that builds the agent's configuration and launches it, one that lets agents spawn other agents, and one that manages fine grained, per command permissions. pi-fleet itself is a thin layer of versioned configuration, wrapper scripts, and skills sitting on top of those three pieces. Setup is done through a single install script that checks for and, on a Mac with Homebrew, offers to install the required dependencies, wires up local configuration without overwriting anything that already exists, and walks the user through authenticating with GitHub, Linear, and their chosen AI provider. It is written in TypeScript and requires Node.js 20 or newer, along with the Pi agent itself already installed and authenticated.

prompts (copy fr)

prompt 1
Set up pi-fleet on my machine and launch a read only reviewer seat for my current project.
prompt 2
Explain the difference between the conductor, project lead, and worker seats in pi-fleet.
prompt 3
Help me customize the tool allowlist for a new custom agent seat in pi-fleet.
prompt 4
Show me how to override the default model for the pi-implementer seat.

Frequently asked questions

what is pi-fleet fr?

A command line system that turns the Pi coding agent into a team of restricted, single purpose AI agents like implementer, reviewer, and researcher.

What language is pi-fleet written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

How hard is pi-fleet to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pi-fleet for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.