singularity-forge/docs/dev/extending-pi/04-extension-locations-discovery.md
Jeremy 872b0adb48 docs: reorganize into user-docs/ and dev/ subdirectories
Split flat docs/ into user-docs/ (guides, config, troubleshooting) and
dev/ (ADRs, architecture, extension guides, proposals). Updated
docs/README.md index to reflect new paths.
2026-04-10 09:25:31 -05:00

765 B

Extension Locations & Discovery

Auto-Discovery Paths

Location Scope
~/.gsd/agent/extensions/*.ts Global (all projects)
~/.gsd/agent/extensions/*/index.ts Global (subdirectory)
.gsd/extensions/*.ts Project-local
.gsd/extensions/*/index.ts Project-local (subdirectory)

Additional Paths (via settings.json)

{
  "extensions": [
    "/path/to/local/extension.ts",
    "/path/to/local/extension/dir"
  ],
  "packages": [
    "npm:@foo/bar@1.0.0",
    "git:github.com/user/repo@v1"
  ]
}

Security Warning

Extensions run with your full system permissions. They can execute arbitrary code, read/write any file, make network requests. Only install from sources you trust.