@benvargas/pi-ancestor-discovery1.1.3

Recursive ancestor discovery for pi resources (skills, prompts, themes)

benvargas Published 2 months ago MIT ~122 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Reports 0

No reports yet.

Readme

@benvargas/pi-ancestor-discovery

Recursive ancestor discovery for pi resources (skills, prompts, themes).

This extension uses the resources_discover hook to walk upward from your current working directory and discover resource folders at each ancestor level. It requires pi (@earendil-works/pi-coding-agent) v0.74.0 or later, per the declared peer dependency. (The hook itself dates back to around pi v0.50.8, but earlier pi versions are not supported by this package.)

Install

pi install npm:@benvargas/pi-ancestor-discovery

Default behavior

Enabled: skills
Disabled: prompts, themes
Search paths: .pi/skills, .agents/skills
Boundary: home directory (~)

This means it will look for .pi/skills and .agents/skills at each ancestor directory from cwd up to your home directory.

Configuration

Create a JSON config file in one of these locations:

Project: .pi/extensions/pi-ancestor-discovery.json
Global: ~/.pi/agent/extensions/pi-ancestor-discovery.json

Project config overrides global config. If neither exists, the extension writes the default config to the global path on first run.

Example: enable prompts and themes

{
  "boundary": "home",
  "resources": {
    "skills": {
      "enabled": true,
      "searchPaths": [".pi/skills", ".agents/skills"]
    },
    "prompts": {
      "enabled": true,
      "searchPaths": [".pi/prompts"]
    },
    "themes": {
      "enabled": true,
      "searchPaths": [".pi/themes"]
    }
  }
}

Example: include Claude skills too

{
  "resources": {
    "skills": {
      "enabled": true,
      "searchPaths": [".pi/skills", ".agents/skills", ".claude/skills"]
    }
  }
}

Boundary options

"home" or "~": stop at the home directory (default)
"root" or "/": stop at the filesystem root
"/absolute/path": stop when that absolute path is reached

The boundary directory is included in the search.

Notes

Paths are returned closest-first, so nearer resources win name collisions.
Absolute or ~-prefixed search paths are treated as fixed locations and appended after ancestor discovery.

Uninstall

pi remove npm:@benvargas/pi-ancestor-discovery

License

MIT