@agnishc/edb-explore

A Pi CLI extension that registers an explore_dir tool. It searches a directory across multiple files to answer a question — without loading any of those files into the main agent's context.

Spawns a dedicated pi sub-agent scoped to the target directory with only read and bash tools. The sub-agent does all the file exploration independently and returns a concise answer with exact file paths and line numbers.

When to use

Use explore_dir when all of these are true:

1. You need information that lives somewhere in a directory
2. You do not already know which specific file contains it
3. Answering would require reading 3 or more files yourself

Don't use when you already know the file (use read directly), a single grep would answer it (use bash), or you need to edit files.

Install

pi install npm:@agnishc/edb-explore

Example

explore_dir(
  question: "Where is the auth middleware registered?",
  directory: "./src"
)

Returns citations like src/middleware/auth.ts:42 with one-line explanations.

Configuration

Set PI_PATH env var if the pi binary is not on PATH.

License

MIT © Agnish Chakraborty