# monotonic-pi-extensions

Experimental monorepo for [Pi coding agent](https://github.com/mariozechner/pi-coding-agent) extensions.

## Extensions

### `pi-turn-limit`

Limits the number of turns (agent round-trips) in a Pi session. When the limit is reached, the user is prompted to continue or abort.

- **Default limit:** 25 turns
- **Override:** set `PI_MAX_TURNS` environment variable to a positive integer
- **Unlimited:** set `PI_MAX_TURNS=unlimited` or run the `turn-limit unlimited` command to disable the boundary check entirely (the counter still increments for observability)
- **Re-enable:** switch from unlimited back to a number via `turn-limit <N>`; the counter resets to 0

See [packages/pi-turn-limit/README.md](packages/pi-turn-limit/README.md) for details and the [Allium spec](packages/pi-turn-limit/turn-limit.allium).

## Installation

This is an early release — not on npm yet. To install from source:

```bash
# Clone the repo
git clone <repo-url>
cd pi-extensions

# Install dependencies
pnpm install

# Link the extension (or reference it directly in your Pi config)
```

Starting pi in this repository will load the turn-limit extension. Make sure you sandbox it properly, e.g. with 'nono', Docker or a VM. Extensions have not been security checked etc.

## Repository Status

**Experimental.** APIs and behavior may change without notice. Feedback welcome.