pi-mono-status-line

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# pi-mono-extensions

`pi-mono-extensions` is a pnpm workspace that collects installable extensions for the [pi coding agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent). Each package under `extensions/` adds a focused capability to pi: new tools, slash commands, TUI panels, workflow automation, security guards, design/product integrations, or bundled skills.

You can install the full bundle with one command, or install only the extensions you need. This README is the top-level catalog; each extension section links to its own README for deeper usage, configuration, and development details.

## Table of Contents

- [Installation](#installation)
- [Extensions](#extensions)
  - [ask-user-question](#ask-user-question)
  - [auto-fix](#auto-fix)
  - [btw](#btw)
  - [clear](#clear)
  - [context](#context)
  - [context-guard](#context-guard)
  - [figma](#figma)
  - [linear](#linear)
  - [goal](#goal)
  - [loop](#loop)
  - [multi-edit](#multi-edit)
  - [provider-request-options](#provider-request-options)
  - [review](#review)
  - [sentinel](#sentinel)
  - [simplify](#simplify)
  - [status-line](#status-line)
  - [team-mode](#team-mode)
  - [usage](#usage)
  - [web-search](#web-search)

## Installation

Install all extensions and bundled skills at once:

```bash
pi install npm:pi-mono-all
```

Or install individual extensions by package name from the sections below.

Load an extension temporarily for local testing:

```bash
pi -e /path/to/pi-extensions/extensions/btw/index.ts
```

## Extensions

### ask-user-question

Full details: [extensions/ask-user-question/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/ask-user-question/README.md).

Registers the `ask_user_question` tool so agents can ask structured questions with interactive TUI controls — radio buttons, checkboxes, and multi-line text inputs — instead of plain-text follow-up questions.

#### Install

```bash
pi install npm:pi-mono-ask-user-question
```

#### Usage

Use the `ask_user_question` tool when a task needs structured user input:

```text
ask_user_question
- radio: choose one option
- checkbox: choose many options
- text: free-form input
```

Example prompts agents can satisfy with this tool:

- “Ask me which implementation option to use.”
- “Let me pick multiple files/features before continuing.”
- “Collect a short free-form requirement before editing code.”

### auto-fix

Full details: [extensions/auto-fix/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/auto-fix/README.md).

Runs language-appropriate fixers such as eslint, prettier, and black on files written during a turn. Fixes are applied silently and summarized once at `agent_end`.

#### Install

```bash
pi install npm:pi-mono-auto-fix
```

#### Usage

Install it and keep working normally. When the agent writes supported files, `auto-fix` queues and runs the matching fixer automatically.

Examples:

```text
Ask pi to edit TypeScript, JavaScript, Python, or formatted text files.
auto-fix applies available project fixers after writes.
```

#### Configuration

See the extension README for supported fixer rules and configuration examples.

### btw

Full details: [extensions/btw/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/btw/README.md).

Adds Claude Code-style `/btw` behavior for asking a quick side question while pi is busy with the main task. Answers appear in a passive widget and are kept out of the visible transcript and future LLM context.

#### Install

```bash
pi install npm:pi-mono-btw
```

#### Usage

```text
/btw What does this error mean?
/btw Give me a shorter name for this function
/btw Summarize the current approach in one paragraph
```

You can also press `Ctrl+Shift+B` to ask the current editor text as a side question.

#### Behavior

- Works while pi is idle or busy.
- Uses the active model and current session transcript as context.
- Stores question/answer metadata as hidden session entries.

### clear

Full details: [extensions/clear/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/clear/README.md).

Adds a `/clear` command that starts a fresh session, similar to the built-in `/new` command.

#### Install

```bash
pi install npm:pi-mono-clear
```

#### Usage

```text
/clear
```

Or press `Ctrl+Shift+L`.

#### Behavior

- If the agent is busy, `/clear` waits for it to finish before switching sessions.
- Creates a new session via `ctx.newSession()`.
- Shows a warning if the new-session request is cancelled and an error notification if clearing fails.

### context

Full details: [extensions/context/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/context/README.md).

Adds a Claude Code-style `/context` command that prints current context-window usage, estimated category breakdown, extension allocation, session stats, and active tool/command sections without adding the report to future LLM context.

#### Install

```bash
pi install npm:pi-mono-context
```

#### Usage

```text
/context
```

The printed report is display-only and filtered from future LLM context.

### context-guard

Full details: [extensions/context-guard/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/context-guard/README.md).

Keeps pi sessions lean by intercepting tool calls before they execute and reducing repeated or unbounded context-heavy output.

#### Install

```bash
pi install npm:pi-mono-context-guard
```

#### Usage

Install it and keep working normally. The extension automatically:

- injects a default `limit` of `120` on `read` calls that omit a limit
- blocks duplicate unchanged `read` calls with the same path, offset, and limit
- appends `| head -60` to unbounded `rg` usage inside `bash` commands

#### Notes

The read dedup cache is session-scoped and invalidates when file mtimes change.

### figma

Full details: [extensions/figma/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/figma/README.md).

Registers native Figma tools for design context, node summaries, rendered screenshots, implementation guidance, text extraction, asset extraction, component hints, Code Connect lookup, and raw JSON debugging escape hatches. It also bundles a Figma skill for design-to-code workflows.

#### Install

```bash
pi install npm:pi-mono-figma
```

#### Authentication

Auth is read from `FIGMA_TOKEN` or `~/.pi/agent/auth.json` at `.figma.token`.

For masked token setup or update, use:

```text
/figma-auth --force
```

Agents can also use the `figma_configure_auth` tool when authentication is missing, expired, invalid, or explicitly requested.

#### Usage

Explain a Figma node:

```text
figma_parse_url
figma_render_nodes
figma_explain_node
```

Implement a design:

```text
figma_parse_url
figma_find_nodes_by_name or figma_find_nodes_by_text
figma_get_implementation_context
figma_extract_assets
```

Useful tools include:

- `figma_get_design_context`
- `figma_get_node_summary`
- `figma_extract_text`
- `figma_get_component_implementation_hints`
- `figma_find_code_connect_mapping`

Rendered/generated image files default to OS temp directories unless `outputDir` is explicitly provided.

### linear

Full details: [extensions/linear/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/linear/README.md).

Registers native Linear tools for workspace metadata, issue search, issue details, create/update/comment operations, projects, cycles, labels, users, documents, file uploads, and Markdown description image reading for issue screenshots. It also bundles a Linear workflow skill.

#### Install

```bash
pi install npm:pi-mono-linear
```

#### Authentication

Auth is read from `LINEAR_API_KEY` or `~/.pi/agent/auth.json` at `.linear.key`.

For masked key setup or update, use:

```text
/linear-auth --force
```

Agents can also use the `linear_configure_auth` tool when authentication is missing, expired, invalid, or explicitly requested.

#### Usage

Find and inspect issues, including Markdown screenshots in issue descriptions when the active model supports image input:

```text
linear_workspace_metadata
linear_search_issues
linear_get_issue
```

Update or comment on an issue:

```text
linear_get_issue
linear_update_issue
linear_create_comment
```

Upload a file to an issue comment:

```text
linear_get_issue
linear_upload_file_to_issue_comment
```

### goal

Full details: [extensions/goal/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/goal/README.md).

Adds a Codex-style `/goal` command with persistent session state, model tools (`get_goal`, `create_goal`, `update_goal`), hidden steering prompts, bounded auto-continuation, basic accounting, and a compact status/widget UI.

#### Install

```bash
pi install npm:pi-mono-goal
```

#### Usage

```text
/goal <goal text>
/goal show
/goal pause
/goal resume
/goal edit <new text>
/goal auto on
/goal budget turns 10
/goal done <summary>
/goal clear
```

### loop

Full details: [extensions/loop/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/loop/README.md).

Adds a `/loop` command that runs a prompt or slash command immediately and then repeats it on a recurring interval.

#### Install

```bash
pi install npm:pi-mono-loop
```

#### Usage

```text
/loop [interval] <prompt>
/loop list
/loop stop
/loop stop <id>
```

Examples:

```text
/loop 5m /review
/loop 30m check the deploy
/loop 1h run the tests and report failures
/loop check the deploy            # defaults to 10m
/loop check the deploy every 20m  # trailing "every" clause
/loop list
/loop stop loop-1
/loop stop
```

#### Behavior

- Supports `s`, `m`, `h`, and `d` interval suffixes.
- Defaults to `10m` when no interval is given.
- Minimum interval is 10 seconds.
- Loops auto-expire after 7 days.
- If the agent is busy when a timer fires, the prompt is queued as a follow-up.

### multi-edit

Full details: [extensions/multi-edit/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/multi-edit/README.md).

Replaces the built-in `edit` tool with an enhanced version that supports classic single edits, batch edits across multiple files, and Codex-style patch payloads, all validated against a virtual filesystem before real writes occur.

#### Install

```bash
pi install npm:pi-mono-multi-edit
```

#### Usage

Classic edit:

```text
edit(path, oldText, newText)
```

Batch edit:

```text
edit(multi: [
  { path, oldText, newText },
  { path, oldText, newText }
])
```

Patch edit:

```text
edit(patch: "*** Begin Patch ... *** End Patch")
```

#### Features

- preflight validation
- atomic multi-file rollback
- same-file positional ordering
- quote-normalized matching for classic edits
- redundant edit detection
- diff generation

### provider-request-options

Full details: [extensions/provider-request-options/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/provider-request-options/README.md).

Deep-merges provider-native fields from `providerRequestOptions` in Pi's active global `settings.json` into serialized API request payloads. Settings are read on every request, and provider keys are matched exactly.

#### Install

```bash
pi install npm:pi-mono-provider-request-options
```

#### Usage

```json
{
  "providerRequestOptions": {
    "openai-codex": {
      "text": { "verbosity": "low" }
    }
  }
}
```

The extension performs no provider-specific validation or translation. Plain objects merge recursively; arrays, scalars, booleans, and `null` replace existing values.

### review

Full details: [extensions/review/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/review/README.md).

Adds `/review` and `/review-tui` for reviewing GitHub pull requests or GitLab merge requests and submitting selected comments through an interactive review UI.

#### Install

```bash
pi install npm:pi-mono-review
```

#### Usage

```text
/review https://github.com/org/repo/pull/123
/review https://gitlab.com/group/project/-/merge_requests/45
/review-tui
```

#### Behavior

- Detects GitHub vs GitLab from the URL.
- Fetches the diff using the appropriate CLI.
- Runs review with a scoped `report_finding` tool when supported, with JSON fallback.
- Prints a compact P0–P3 findings summary.
- Stores the review for `/review-tui`, where findings can be approved, dismissed, edited, and submitted.

### sentinel

Full details: [extensions/sentinel/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/sentinel/README.md).

Adds content-aware security guards that pre-scan reads for secret patterns, track write/execute correlation, gate risky bash/write/edit operations, and provide a local token vault for `$TOKEN_name` placeholders without exposing secret values to the LLM.

#### Install

```bash
pi install npm:pi-mono-sentinel
```

#### Usage

Install it and keep working normally. `sentinel` automatically guards supported tool calls.

Examples of guarded behavior:

- blocks or warns on reads that appear to contain secrets
- asks for confirmation before indirectly executing newly written files
- lets agents reference stored credentials by placeholder rather than raw secret value

### simplify

Full details: [extensions/simplify/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/simplify/README.md).

Adds a `/simplify` command that reviews git-changed files for code reuse, quality, and efficiency, then fixes any issues found.

#### Install

```bash
pi install npm:pi-mono-simplify
```

#### Usage

```text
/simplify
/simplify <additional focus>
```

Examples:

```text
/simplify
/simplify focus on performance and memory usage
/simplify pay extra attention to React re-renders
```

#### Behavior

- Runs `git diff` or `git diff HEAD` to identify changed files.
- Launches parallel review agents for code reuse, code quality, and efficiency.
- Aggregates findings, applies fixes directly, and summarizes changes.
- Appends any extra text after `/simplify` as additional review focus.

### status-line

Full details: [extensions/status-line/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/status-line/README.md).

Adds a configurable footer with `basic` and `expert` modes. Basic mode shows a compact two-line layout with token stats; expert mode adds a visual context gauge, enhanced git status, session cost, and subscription usage indicators.

#### Install

```bash
pi install npm:pi-mono-status-line
```

#### Usage

Install it and start pi normally. Configure the mode with `PI_STATUS_LINE_MODE` or `~/.pi/agent/status-line.json`.

Examples:

```bash
PI_STATUS_LINE_MODE=expert pi
```

```json
{
  "mode": "basic"
}
```

### team-mode

Full details: [extensions/team-mode/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/team-mode/README.md).

Adds flat peer-agent orchestration: named, addressable workers spawned as isolated pi subprocesses with resumable context, task notifications, continuation via `send_message`, and a shared TODO board with CAS version counters.

#### Install

```bash
pi install npm:pi-mono-team-mode
```

#### Usage

Agents can spawn and coordinate teammates with tools such as:

```text
agent
send_message
task_create
task_update
task_list
```

Typical workflow:

```text
agent(description: "Research API", name: "api-researcher", prompt: "...")
# wait for <task-notification>
send_message(to: "api-researcher", message: "Follow up with ...")
```

#### Extra

- Supports isolated worktrees for worker edits.
- Supports teammate role specs from `.pi/teammates/` or `.claude/teammates/`.
- Supports delegate groups and live progress.

### usage

Full details: [extensions/usage/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/usage/README.md).

Adds a `/usage` command that aggregates local pi session files and renders an inline dashboard for usage, cost drivers, provider/model breakdowns, and environmental footprint estimates.

#### Install

```bash
pi install npm:pi-mono-usage
```

#### Usage

```text
/usage
```

Inside the dashboard:

- `Tab` or arrows cycle the period: Today, This Week, Last Week, All Time.
- `v` or `1`/`2`/`3` switch views.
- `q` or `Esc` closes the panel.

#### Views

- **Summary** — totals, top providers, and footprint estimate.
- **Providers** — per-provider table with expandable per-model rows.
- **Patterns** — cost-driver insights.

### web-search

Full details: [extensions/web-search/README.md](https://github.com/emanuelcasco/pi-mono-extensions/blob/HEAD/extensions/web-search/README.md).

Registers native `web_search` and `web_read` tools for online research. Search uses DuckDuckGo result pages, and page reading extracts readable article text with Mozilla Readability plus a lightweight HTML fallback.

#### Install

```bash
pi install npm:pi-mono-web-search
```

#### Usage

Search the web:

```text
web_search(query: "pi coding agent extensions", maxResults: 5)
```

Read a result or known URL:

```text
web_read(url: "https://example.com/article")
```

Typical workflow:

```text
web_search
web_read
summarize or cite findings
```

#### Tools

- `web_search` — returns titles, URLs, and snippets.
- `web_read` — fetches a URL and returns cleaned readable content.

pi-mono-extensions

pi-mono-extensions is a pnpm workspace that collects installable extensions for the pi coding agent. Each package under extensions/ adds a focused capability to pi: new tools, slash commands, TUI panels, workflow automation, security guards, design/product integrations, or bundled skills.

You can install the full bundle with one command, or install only the extensions you need. This README is the top-level catalog; each extension section links to its own README for deeper usage, configuration, and development details.

Installation
Extensions
- ask-user-question
- auto-fix
- btw
- clear
- context
- context-guard
- figma
- linear
- goal
- loop
- multi-edit
- provider-request-options
- review
- sentinel
- simplify
- status-line
- team-mode
- usage
- web-search

Installation

Install all extensions and bundled skills at once:

pi install npm:pi-mono-all

Or install individual extensions by package name from the sections below.

Load an extension temporarily for local testing:

pi -e /path/to/pi-extensions/extensions/btw/index.ts

Extensions

ask-user-question

Full details: extensions/ask-user-question/README.md.

Registers the ask_user_question tool so agents can ask structured questions with interactive TUI controls — radio buttons, checkboxes, and multi-line text inputs — instead of plain-text follow-up questions.

Install

pi install npm:pi-mono-ask-user-question

Usage

Use the ask_user_question tool when a task needs structured user input:

ask_user_question
- radio: choose one option
- checkbox: choose many options
- text: free-form input

Example prompts agents can satisfy with this tool:

“Ask me which implementation option to use.”
“Let me pick multiple files/features before continuing.”
“Collect a short free-form requirement before editing code.”

auto-fix

Full details: extensions/auto-fix/README.md.

Runs language-appropriate fixers such as eslint, prettier, and black on files written during a turn. Fixes are applied silently and summarized once at agent_end.

Install

pi install npm:pi-mono-auto-fix

Usage

Install it and keep working normally. When the agent writes supported files, auto-fix queues and runs the matching fixer automatically.

Examples:

Ask pi to edit TypeScript, JavaScript, Python, or formatted text files.
auto-fix applies available project fixers after writes.

Configuration

See the extension README for supported fixer rules and configuration examples.

btw

Full details: extensions/btw/README.md.

Adds Claude Code-style /btw behavior for asking a quick side question while pi is busy with the main task. Answers appear in a passive widget and are kept out of the visible transcript and future LLM context.

Install

pi install npm:pi-mono-btw

Usage

/btw What does this error mean?
/btw Give me a shorter name for this function
/btw Summarize the current approach in one paragraph

You can also press Ctrl+Shift+B to ask the current editor text as a side question.

Behavior

Works while pi is idle or busy.
Uses the active model and current session transcript as context.
Stores question/answer metadata as hidden session entries.

clear

Full details: extensions/clear/README.md.

Adds a /clear command that starts a fresh session, similar to the built-in /new command.

Install

pi install npm:pi-mono-clear

Usage

/clear

Or press Ctrl+Shift+L.

Behavior

If the agent is busy, /clear waits for it to finish before switching sessions.
Creates a new session via ctx.newSession().
Shows a warning if the new-session request is cancelled and an error notification if clearing fails.

context

Full details: extensions/context/README.md.

Adds a Claude Code-style /context command that prints current context-window usage, estimated category breakdown, extension allocation, session stats, and active tool/command sections without adding the report to future LLM context.

Install

pi install npm:pi-mono-context

Usage

/context

The printed report is display-only and filtered from future LLM context.

context-guard

Full details: extensions/context-guard/README.md.

Keeps pi sessions lean by intercepting tool calls before they execute and reducing repeated or unbounded context-heavy output.

Install

pi install npm:pi-mono-context-guard

Usage

Install it and keep working normally. The extension automatically:

injects a default limit of 120 on read calls that omit a limit
blocks duplicate unchanged read calls with the same path, offset, and limit
appends | head -60 to unbounded rg usage inside bash commands

Notes

The read dedup cache is session-scoped and invalidates when file mtimes change.

figma

Full details: extensions/figma/README.md.

Registers native Figma tools for design context, node summaries, rendered screenshots, implementation guidance, text extraction, asset extraction, component hints, Code Connect lookup, and raw JSON debugging escape hatches. It also bundles a Figma skill for design-to-code workflows.

Install

pi install npm:pi-mono-figma

Authentication

Auth is read from FIGMA_TOKEN or ~/.pi/agent/auth.json at .figma.token.

For masked token setup or update, use:

/figma-auth --force

Agents can also use the figma_configure_auth tool when authentication is missing, expired, invalid, or explicitly requested.

Usage

Explain a Figma node:

figma_parse_url
figma_render_nodes
figma_explain_node

Implement a design:

figma_parse_url
figma_find_nodes_by_name or figma_find_nodes_by_text
figma_get_implementation_context
figma_extract_assets

Useful tools include:

figma_get_design_context
figma_get_node_summary
figma_extract_text
figma_get_component_implementation_hints
figma_find_code_connect_mapping

Rendered/generated image files default to OS temp directories unless outputDir is explicitly provided.

linear

Full details: extensions/linear/README.md.

Registers native Linear tools for workspace metadata, issue search, issue details, create/update/comment operations, projects, cycles, labels, users, documents, file uploads, and Markdown description image reading for issue screenshots. It also bundles a Linear workflow skill.

Install

pi install npm:pi-mono-linear

Authentication

Auth is read from LINEAR_API_KEY or ~/.pi/agent/auth.json at .linear.key.

For masked key setup or update, use:

/linear-auth --force

Agents can also use the linear_configure_auth tool when authentication is missing, expired, invalid, or explicitly requested.

Usage

Find and inspect issues, including Markdown screenshots in issue descriptions when the active model supports image input:

linear_workspace_metadata
linear_search_issues
linear_get_issue

Update or comment on an issue:

linear_get_issue
linear_update_issue
linear_create_comment

Upload a file to an issue comment:

linear_get_issue
linear_upload_file_to_issue_comment

goal

Full details: extensions/goal/README.md.

Adds a Codex-style /goal command with persistent session state, model tools (get_goal, create_goal, update_goal), hidden steering prompts, bounded auto-continuation, basic accounting, and a compact status/widget UI.

Install

pi install npm:pi-mono-goal

Usage

/goal <goal text>
/goal show
/goal pause
/goal resume
/goal edit <new text>
/goal auto on
/goal budget turns 10
/goal done <summary>
/goal clear

loop

Full details: extensions/loop/README.md.

Adds a /loop command that runs a prompt or slash command immediately and then repeats it on a recurring interval.

Install

pi install npm:pi-mono-loop

Usage

/loop [interval] <prompt>
/loop list
/loop stop
/loop stop <id>

Examples:

/loop 5m /review
/loop 30m check the deploy
/loop 1h run the tests and report failures
/loop check the deploy            # defaults to 10m
/loop check the deploy every 20m  # trailing "every" clause
/loop list
/loop stop loop-1
/loop stop

Behavior

Supports s, m, h, and d interval suffixes.
Defaults to 10m when no interval is given.
Minimum interval is 10 seconds.
Loops auto-expire after 7 days.
If the agent is busy when a timer fires, the prompt is queued as a follow-up.

multi-edit

Full details: extensions/multi-edit/README.md.

Replaces the built-in edit tool with an enhanced version that supports classic single edits, batch edits across multiple files, and Codex-style patch payloads, all validated against a virtual filesystem before real writes occur.

Install

pi install npm:pi-mono-multi-edit

Usage

Classic edit:

edit(path, oldText, newText)

Batch edit:

edit(multi: [
  { path, oldText, newText },
  { path, oldText, newText }
])

Patch edit:

edit(patch: "*** Begin Patch ... *** End Patch")

Features

preflight validation
atomic multi-file rollback
same-file positional ordering
quote-normalized matching for classic edits
redundant edit detection
diff generation

provider-request-options

Full details: extensions/provider-request-options/README.md.

Deep-merges provider-native fields from providerRequestOptions in Pi's active global settings.json into serialized API request payloads. Settings are read on every request, and provider keys are matched exactly.

Install

pi install npm:pi-mono-provider-request-options

Usage

{
  "providerRequestOptions": {
    "openai-codex": {
      "text": { "verbosity": "low" }
    }
  }
}

The extension performs no provider-specific validation or translation. Plain objects merge recursively; arrays, scalars, booleans, and null replace existing values.

review

Full details: extensions/review/README.md.

Adds /review and /review-tui for reviewing GitHub pull requests or GitLab merge requests and submitting selected comments through an interactive review UI.

Install

pi install npm:pi-mono-review

Usage

/review https://github.com/org/repo/pull/123
/review https://gitlab.com/group/project/-/merge_requests/45
/review-tui

Behavior

Detects GitHub vs GitLab from the URL.
Fetches the diff using the appropriate CLI.
Runs review with a scoped report_finding tool when supported, with JSON fallback.
Prints a compact P0–P3 findings summary.
Stores the review for /review-tui, where findings can be approved, dismissed, edited, and submitted.

sentinel

Full details: extensions/sentinel/README.md.

Adds content-aware security guards that pre-scan reads for secret patterns, track write/execute correlation, gate risky bash/write/edit operations, and provide a local token vault for $TOKEN_name placeholders without exposing secret values to the LLM.

Install

pi install npm:pi-mono-sentinel

Usage

Install it and keep working normally. sentinel automatically guards supported tool calls.

Examples of guarded behavior:

blocks or warns on reads that appear to contain secrets
asks for confirmation before indirectly executing newly written files
lets agents reference stored credentials by placeholder rather than raw secret value

simplify

Full details: extensions/simplify/README.md.

Adds a /simplify command that reviews git-changed files for code reuse, quality, and efficiency, then fixes any issues found.

Install

pi install npm:pi-mono-simplify

Usage

/simplify
/simplify <additional focus>

Examples:

/simplify
/simplify focus on performance and memory usage
/simplify pay extra attention to React re-renders

Behavior

Runs git diff or git diff HEAD to identify changed files.
Launches parallel review agents for code reuse, code quality, and efficiency.
Aggregates findings, applies fixes directly, and summarizes changes.
Appends any extra text after /simplify as additional review focus.

status-line

Full details: extensions/status-line/README.md.

Adds a configurable footer with basic and expert modes. Basic mode shows a compact two-line layout with token stats; expert mode adds a visual context gauge, enhanced git status, session cost, and subscription usage indicators.

Install

pi install npm:pi-mono-status-line

Usage

Install it and start pi normally. Configure the mode with PI_STATUS_LINE_MODE or ~/.pi/agent/status-line.json.

Examples:

PI_STATUS_LINE_MODE=expert pi

{
  "mode": "basic"
}

team-mode

Full details: extensions/team-mode/README.md.

Adds flat peer-agent orchestration: named, addressable workers spawned as isolated pi subprocesses with resumable context, task notifications, continuation via send_message, and a shared TODO board with CAS version counters.

Install

pi install npm:pi-mono-team-mode

Usage

Agents can spawn and coordinate teammates with tools such as:

agent
send_message
task_create
task_update
task_list

Typical workflow:

agent(description: "Research API", name: "api-researcher", prompt: "...")
# wait for <task-notification>
send_message(to: "api-researcher", message: "Follow up with ...")

Extra

Supports isolated worktrees for worker edits.
Supports teammate role specs from .pi/teammates/ or .claude/teammates/.
Supports delegate groups and live progress.

usage

Full details: extensions/usage/README.md.

Adds a /usage command that aggregates local pi session files and renders an inline dashboard for usage, cost drivers, provider/model breakdowns, and environmental footprint estimates.

Install

pi install npm:pi-mono-usage

Usage

/usage

Inside the dashboard:

Tab or arrows cycle the period: Today, This Week, Last Week, All Time.
v or 1/2/3 switch views.
q or Esc closes the panel.

Views

Summary — totals, top providers, and footprint estimate.
Providers — per-provider table with expandable per-model rows.
Patterns — cost-driver insights.

web-search

Full details: extensions/web-search/README.md.

Registers native web_search and web_read tools for online research. Search uses DuckDuckGo result pages, and page reading extracts readable article text with Mozilla Readability plus a lightweight HTML fallback.

Install

pi install npm:pi-mono-web-search

Usage

Search the web:

web_search(query: "pi coding agent extensions", maxResults: 5)

Read a result or known URL:

web_read(url: "https://example.com/article")

Typical workflow:

web_search
web_read
summarize or cite findings

Tools

web_search — returns titles, URLs, and snippets.
web_read — fetches a URL and returns cleaned readable content.