singularity-forge/docs-internal/extending-pi/04-extension-locations-discovery.md
Lex Christopherson d20d5e8fb5 docs: add Mintlify documentation site and move internal docs
Add a proper public-facing documentation site using Mintlify with 19 MDX
pages covering getting started, auto mode, commands, configuration, and
all user-facing features. Move internal/SDK documentation (Pi SDK, TUI,
context & hooks, research notes, ADRs) to docs-internal/ since they
should not be part of the public documentation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 09:54:41 -06: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.