README.md
xonecas' Pi extensions
Personal Pi extensions, kept in one source-controlled collection.
Extensions
adversary
Adds the adversary_review tool. The main agent can delegate an independent review to an isolated Pi process.
The child receives the built-in read, grep, find, ls, and bash tools. Its model, thinking level, and review instructions are loaded from extensions/adversary/adversary.md each time the tool runs:
---
model: yourprovider/youradversarymodelchoice
thinking: high
---
Reviewer instructions go here.
Edit that file to change the reviewer without reloading the extension. While a review runs, the tool display follows the child's latest tool action and then shows when it starts writing findings.
Ask Pi naturally:
Use the adversary to review the current work against my request.
exa
Adds two tools, both served by Exa's hosted MCP server:
exa_searchsearches the web. It sendsautosearches with relevant highlights by default and supports Exa's other search types (fast,instant,deep-lite,deep,deep-reasoning) when deeper or faster retrieval is useful.exa_contentsreads the full content of one or more known URLs as clean markdown. Use it when the search highlights are not enough.
EXA_API_KEY is optional. Every call tries the free anonymous tier first. When a key is set and the free tier rate-limits the call, the extension waits briefly, retries once anonymously, and then falls back to the key. Tool details report keyed and rateLimitRetries, so paid calls are visible. Without a key, rate-limited calls fail with Exa's own message, which explains how to add one.
Ask Pi naturally:
Search the web for the latest Exa API changes.
Read https://exa.ai/docs/reference/get-contents and summarize the parameters.
Enable or disable
Extensions remain here. Pi discovers enabled extensions through symlinks in ~/.pi/agent/extensions.
Enable:
mkdir -p ~/.pi/agent/extensions
ln -s extensions/adversary ~/.pi/agent/extensions/adversary
ln -s extensions/exa ~/.pi/agent/extensions/exa
Disable:
rm ~/.pi/agent/extensions/adversary
rm ~/.pi/agent/extensions/exa
Run /reload after either change, or restart Pi.
For a one-off session without enabling it globally:
pi -e extensions/adversary/index.ts
pi -e extensions/exa/index.ts