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
This commit is contained in:
Mario Zechner 2025-11-12 23:28:40 +01:00
parent 271810c808
commit 42e0cbd4f4

View file

@ -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