Repolode
Submit
mavam

mavam/pi-agents

Durable, named agents for the Pi coding agent that run delegated tasks in the background, can be messaged, and survive restarts.

View on GitHub
Stars
89
Forks
6
Open issues
0
Last commit
4 days ago

What is it?

pi-agents is an extension for Pi that lets you hand a task to a named agent and keep working while it runs. When the agent finishes, its final message comes back into your Pi conversation. You can watch any running agent live, send it messages, attach to its session, or stop it.

Agents are stored durably, so they survive crashes and restarts. Agents can also be arranged into graphs, where agents pass results to one another and Pi receives a single combined message at the end. Agents may spawn further agents, which makes it possible to fan out work such as reviewing each file in a directory and merging the findings.

Agents run inside the Pi process and reuse your Pi logins, models, MCP servers, and shared extension tools. Installation is done with pi install npm:pi-agents.

Key features

  • 01Delegate tasks to named agents that run in the background
  • 02Watch, message, attach to, or stop running agents
  • 03Agent state persists across crashes and restarts
  • 04Compose agents into graphs that pass results between them
  • 05Agents can spawn further agents to split up work
  • 06Reuses Pi's models, logins, MCP servers, and extension tools

Use cases

  • Running a code review in the background while continuing your own work
  • Splitting a codebase audit across parallel agents and merging their findings
  • Coordinating a fix between two agents that exchange messages
  • Running the same review on several models and comparing the results

Quick start

  1. 1

    Install the package into Pi

    pi install npm:pi-agents
  2. 2

    In Pi, ask an agent to run a delegated task in the background

Things to know

  • It runs only inside the Pi coding agent, so you need Pi installed and set up first.

In collections

Open-source AI agent frameworks & appsAI coding assistants & agents

Topics

#agents#coding-agent#multi-agent#durable-execution#subagents#typescript#pi#pi-durable#pi-extension#pi-package

FAQ

What is pi-agents?
Durable, named agents for the Pi coding agent that run delegated tasks in the background, can be messaged, and survive restarts. pi-agents is an extension for Pi that lets you hand a task to a named agent and keep working while it runs. When the agent finishes, its final message comes back into your Pi conversation. You can watch any running agent live, send it messages, attach to its session, or stop it.
Is pi-agents free to use? What license does it have?
pi-agents is open source under the MIT license. Check the license terms before using it in commercial products.
Is pi-agents still maintained?
Actively maintained. The last commit to pi-agents was on Nov 2, 2026.
What can I use pi-agents for?
Running a code review in the background while continuing your own work Splitting a codebase audit across parallel agents and merging their findings Coordinating a fix between two agents that exchange messages Running the same review on several models and comparing the results
How do I install pi-agents?
Install the package into Pi: pi install npm:pi-agents In Pi, ask an agent to run a delegated task in the background
Where can I get pi-agents?
The source code and installation instructions are on GitHub: https://github.com/mavam/pi-agents

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects