Back to Agents
mono-pilot
qianwan February 25, 2026
1 copies 0 downloads
A lean, Cursor-style coding agent built on pi. Take full control of your AI workflow with a custom tool layer (ApplyPatch, rg, Glob), transparent prompt inspection, and native Model Context Protocol (MCP) integrations.
Agent Definition
# MonoPilot
> Cursor-compatible coding agent profile powered by [pi](https://github.com/badlogic/pi-mono).
MonoPilot is a lightweight, highly customizable Cursor-compatible coding agent built on top of the [pi](https://github.com/badlogic/pi-mono) framework. It is designed for developers who want full control over how their coding agent behaves, prefer not to pay a middleman, and want to explore the limits of a lean agent architecture.
## Why MonoPilot
- Transparent prompt/runtime envelope with inspection tooling.
- Cursor-styled tool layer replaces default pi tools so launch-time capability and behavior are defined by MonoPilot.
- Extensible tool layer with MCP support for custom tools and resources.
## Quickstart
```bash
# Run directly without global install
npx mono-pilot
# Or install globally
npm install -g mono-pilot
mono-pilot
```
## Usage
```bash
# Interactive
mono-pilot
# One-shot prompt
mono-pilot -p "Refactor this module"
# Continue previous session
mono-pilot --continue
```
By default, `mono-pilot` launches pi with:
- `--no-extensions`
- `--extension <mono-pilot extension>`
- `--tools ls` (only when you do not pass `--tools` or `--no-tools`)
If you pass `--tools`, MonoPilot removes built-in `edit`, `write`, `read`, `grep`, `glob`, and `bash` so the extension-provided Cursor-styled tools are used instead. If the list becomes empty, it falls back to `ls`. The write path is provided by the `ApplyPatch` tool from the extension.
## What ships now
- `src/cli.ts` – launcher that wraps `pi`
- `src/extensions/mono-pilot.ts` – extension entrypoint (tool wiring)
- `src/extensions/system-prompt.ts` – provider-agnostic prompt stack
- `src/extensions/user-message.ts` – user message envelope assembly
- `src/brief/` – persistent agent memory ("brief" system), inspired by [letta-ai/letta-code](https://github.com/letta-ai/letta-code.git)'s memory architecture, renamed from "memory" to "brief" to distinguish condensed knowledge from conversation history
- `sComments
More Agents
View alldocumentation
Documentation & Onboarding Agent
Agent that generates comprehensive documentation, API references, architecture diagrams, and developer onboarding guides from existing code.
C
Communitydebugging
Cursor Bug Triage Agent
Agent configuration for systematic bug investigation that traces issues from error logs through the codebase to root cause with suggested fixes.
C
Communityapi
API Integration Agent
Agent for integrating third-party APIs including SDK setup, type generation, error handling, retry logic, and rate limit management.
C
Communitycoding
Cursor Agent Mode
Cursor's built-in autonomous coding agent that can make multi-file edits, run terminal commands, search the codebase, and iteratively build features with minimal human intervention.
C
Cursor Teamcloud
Cursor Background Agent
Cloud-based autonomous coding agent that runs in the background on remote sandboxed environments, handling complex multi-step tasks while you continue working.
C
Cursor Teamcomposer
Cursor Composer Agent
Cursor's multi-file editing agent within Composer mode that can create, edit, and delete files across your entire project in a single conversation.
C
Cursor Team