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