singularity-forge/docs/dev/extending-pi/04-extension-locations-discovery.md
ace-pm b29c12d5e5 refactor(native): rename gsd_parser.rs to forge_parser.rs
Final rebrand: rename remaining Rust source file to complete the gsd → forge
transition. All parser references already use forge_parser after earlier commits.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:58:21 +02:00

761 B

Extension Locations & Discovery

Auto-Discovery Paths

Location Scope
~/.sf/agent/extensions/*.ts Global (all projects)
~/.sf/agent/extensions/*/index.ts Global (subdirectory)
.sf/extensions/*.ts Project-local
.sf/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.