From 42e0cbd4f45138441888b081ce4be4dbd6b97d1e Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Wed, 12 Nov 2025 23:28:40 +0100 Subject: [PATCH] docs: add real-world example linking to exa-search tools - Reference exa-search repo as concrete example - Shows web search capability via simple tool pattern - Demonstrates how easy it is to extend pi with custom tools --- packages/coding-agent/README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md index 9d351c80..e63bf3f2 100644 --- a/packages/coding-agent/README.md +++ b/packages/coding-agent/README.md @@ -366,6 +366,10 @@ You can also reference tool READMEs in your `AGENT.md` files to make them automa - Global: `~/.pi/agent/AGENT.md` - available in all sessions - Project-specific: `./AGENT.md` - available in this project +**Real-world example:** + +The [exa-search](https://github.com/badlogic/exa-search) tools provide web search capabilities via the Exa API. Just tell your agent: "Read ~/agent-tools/exa-search/README.md and search for X". + For a detailed walkthrough with real examples, and the reasons for and benefits of this decision, see: https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/ ## Security (YOLO by default) @@ -455,9 +459,7 @@ The agent can read, update, and reference the plan as it works. Unlike ephemeral ## Background Bash -**pi does not and will not implement background bash execution.** Instead, tell the agent to use `tmux` or something like [tterminal-cp](https://github.com/badlogic/tterminal-cp). - -Long-running commands belong in proper terminal sessions, not as detached processes that complicate cleanup and monitoring. +**pi does not and will not implement background bash execution.** Instead, tell the agent to use `tmux` or something like [tterminal-cp](https://mariozechner.at/posts/2025-08-15-mcp-vs-cli/). Bonus points: you can watch the agent interact with a CLI like a debugger and even intervene if necessary. ## Planned Features