pi-manage-dirs

Add external directories to Pi's workspace context with interactive path autocompletion, AGENTS.md loading, and skill registration

Package details

← Back
extension

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

npm report
$ pi install npm:pi-manage-dirs
Package
pi-manage-dirs
Version
1.1.2
Published
May 2, 2026
Downloads
not available
Author
localredhead
License
MIT
Types
extension
Size
34 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-manage-dirs

Add external directories to your Pi workspace with interactive path autocompletion, smart suggestions, AGENTS.md/CLAUDE.md loading, and skill registration.

Type a path, press Tab, and navigate with breadcrumb-style directory suggestions — including ~/ home expansion.

Install

pi install git:github.com/localredhead/pi-manage-dirs

Or from npm:

pi install npm:pi-manage-dirs

Then /reload in Pi.

Usage

Unified /manage-dirs command

Everything lives under one command with subcommand routing and Tab completion:

/manage-dirs                  ← interactive suggestions
/manage-dirs ~/org            ← add a directory (Tab to navigate)
/manage-dirs ls               ← list added directories
/manage-dirs rm 0             ← remove by index
/manage-dirs rm org           ← remove by label
/manage-dirs suggest          ← scored project-aware suggestions
/manage-dirs help             ← show all subcommands

Tab completion

When typing a path after /manage-dirs, press Tab to navigate directory trees:

/manage-dirs ~/          Tab → browse home dirs
/manage-dirs ~/Doc       Tab → ~/Documents/

How It Works

When you add a directory, pi-manage-dirs scans it for:

File Locations checked
AGENTS.md <dir>/AGENTS.md, <dir>/.pi/AGENTS.md
CLAUDE.md <dir>/CLAUDE.md, <dir>/.pi/CLAUDE.md
Skills <dir>/.pi/skills/*/SKILL.md, <dir>/.agents/skills/*/SKILL.md, <dir>/.claude/skills/*/SKILL.md

Context files are injected into the system prompt on every turn (cached). Skills are registered natively via resources_discover.

Smart Suggestions

Run ~ or /manage-dirs suggest to get project-aware recommendations:

  • Sibling projects in the same git repo
  • Local dependencies (file:, link:, portal: in package.json, path: in Cargo.toml, etc.)
  • Workspace members (npm, pnpm, Cargo, Go, uv)
  • Directories with AGENTS.md/CLAUDE.md or skills

Features

  • Breadcrumb autocomplete with ~/ home expansion
  • Smart suggestions from project structure analysis
  • AGENTS.md / CLAUDE.md context injection
  • Skill registration from external directories
  • Status widget showing active directories
  • LLM tools: add_directory, search_external_files
  • Session persistence across /resume and restarts
  • Zero overhead when no directories are added

License

MIT