pi-explorer

Pi skill + command for deep codebase exploration and HTML architecture reports.

Package details

← Back
extensionskill

Install pi-explorer from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-explorer
Package
pi-explorer
Version
0.1.0
Published
Apr 19, 2026
Downloads
130/mo · 11/wk
Author
alpino13
License
MIT
Types
extension, skill
Size
24.5 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-explorer

A Pi package that adds:

  • explorer skill: deeply explores the current repo and generates an HTML architecture/pattern report
  • /explorer command: indexes report directories, lets you browse them in a TUI, and opens the selected HTML in your browser

Install

From npm:

pi install npm:pi-explorer

From GitHub:

pi install git:github.com/AlvaroRausell/pi-explorer

Then reload Pi:

/reload

Contents

  • skills/explorer/ — skill instructions, references, and report publishing script
  • extensions/explorer.js — /explorer command

Report location

By default, reports are written into the repo you are currently in:

<repo>/.pi/explorer-reports

Example:

/home/a/repos/my-app/.pi/explorer-reports

Usage

Generate a report for the repo you are currently inside:

/skill:explorer

Index the current repo's report directory so /explorer can browse it later:

/explorer index

Browse reports from the current repo only:

/explorer here
/explorer latest here

Browse reports across indexed report directories:

/explorer
/explorer latest

Unindex the current repo's report directory:

/explorer unindex

How it works

  • The skill always explores the current working directory.
  • Reports are stored per-repo instead of in one global report store.
  • /explorer uses ~/.pi/agent/explorer-index.json to remember which report directories you indexed.
  • Published reports include an index.json manifest in each repo's .pi/explorer-reports directory.