{"_id":"@bacnh85/pi-references","_rev":"9-769c8a87a475967576508c93e6c8ff91","name":"@bacnh85/pi-references","dist-tags":{"latest":"0.1.8"},"versions":{"0.1.0":{"name":"@bacnh85/pi-references","version":"0.1.0","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.0","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"5a98bb768cc1d53addf464de947d9183071cd2d8","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.0.tgz","fileCount":5,"integrity":"sha512-oH7T6y8tHALsA9CWJyf8c8g7UbhHLIs8OVvGW10FCy5E1qnWWdLcx05hSXw10WpCl9Q1o5uWpVVKO3lMjo+J2w==","signatures":[{"sig":"MEQCIDobQuglerL0XpeBEHLU7bfyMO5nJAAt8WjedhndgyaCAiAEM2kG4IlK4T2yMU1GgJ0qYFePgwNQxIy1B7ozzbJpfw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10803},"gitHead":"d85605e70d509cba6cdd414473defc5348168194","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.0_1786205309716_0.7916506738411639","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bacnh85/pi-references","version":"0.1.1","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.1","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"955b91fcec85bc4bf3f821227599860764343a1a","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.1.tgz","fileCount":5,"integrity":"sha512-X+M5ON9zRCW6ZDzfIM6axDY1/7thNfbzroTN9A8nrFxiXgXS+vfkcgJkxH/A5Rtfob3nAcmV5+KK3Qq2CgjDBw==","signatures":[{"sig":"MEQCIEphprAuvJxYYd3o+kkPqiimKpX3IsKY8W5UVOylslQvAiAOSU2Yik9anwJbKFmvE/+Ce4FgetM4GTaha0YfH47btA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12457},"gitHead":"7831b5745aed34678f18e7c50d2a7777b853500c","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.1_1786438827215_0.9630723212376453","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bacnh85/pi-references","version":"0.1.2","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.2","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"cecfcc88533e82876a64d3a551b21343b3039da8","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.2.tgz","fileCount":5,"integrity":"sha512-G9FUjaNSYhXhdwOUZ8F2edVKhf/3rOk71wJdAXA1AHSOBzBttbM34VmLl+w+x+9sjgV2xP33oLwThKAbk5EwCg==","signatures":[{"sig":"MEQCIDLopd1LjozIpdZzGAxTkuR2ItMt2I7RiX9ngUHXTsTtAiBKzTOcVDaeDcUvwitMIgPogpnLd86hNSCM3cFEQ7nDTw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC5LlqkaBzxUphZjrm19gVBhLrjKNMwmIMVuDBlUY91YQIgI1A/dd0lTI2ccGJaPUFI+/KzxpC7W3LGABfD1IkpyBI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13417},"gitHead":"fc25702c6bed994da1dd5071c5ec8071bfd28393","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.2_1789204407910_0.701780840515208","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@bacnh85/pi-references","version":"0.1.3","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.3","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"4f58bafe9e3d3cdad60f9f27393961b7b3fd8e9b","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.3.tgz","fileCount":5,"integrity":"sha512-y6vxJ5QxAQM702fppRxwQRAPtWpNZpLFrGwyRByeEzg+rd6pZPo1A3MV2JSpedJJ5UDJA3ujpRXL2DNnkE8xyg==","signatures":[{"sig":"MEUCIE6Xu3wBeleyjMrXWFq/Z2l6OpcE+jPWGv5clwNdyanvAiEA3jx5AZwwKYzEiyEezCOaBvUkWzSNTaoEzfNI3B1cQvU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIF3e5r968/JS/1YXbULfshMG7R+V3bcK0o2pvX5qoJ+eAiBiiZnOR9C8kbKXgmgvvhsvHv693aKzaStd3WSVwgCXCA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14753},"gitHead":"d00c3deaa5f3423b44adc2e160397b2feaf8465f","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.3_1789881005530_0.6544824639151043","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@bacnh85/pi-references","version":"0.1.4","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.4","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"5ec03d376056365c1e2904687442940d7b3c79d7","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.4.tgz","fileCount":5,"integrity":"sha512-QfcJNXUfZMFISD2Go6+81HHRlqwcPV+XZFa/mkMjSbSLYPCd0z9dCKEX67m5UUzrUFSMGcXRw4nyMJsZzmKwBw==","signatures":[{"sig":"MEYCIQC9RzSNKLAE9+ROo+ZifBXXGguDFwvvM2LqPmrFw/nMZgIhAN44MTPwboucwjPqeEruheLnOK2xJ7RrOJJLbxrTA25C","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIGjQJCdYS1XhG3Ku9Vw1G0zmsUj4Rm3DLd6KL1Nd5Gx7AiAx5EqH7pujl9nleMKBwzPDyKADJNROHiXTfrDw4ve72A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15522},"gitHead":"b5330ac3d014f92dff97a2b90cd9ebdbf0de22fd","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.4_1789962659971_0.9042707843580335","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@bacnh85/pi-references","version":"0.1.5","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.5","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"1f09c3425233749c680fcc203918236145610fc2","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.5.tgz","fileCount":5,"integrity":"sha512-Lop2oMw2eiMqXozXB9iUbOMFhHphTfSg4+4UUCZ2B13oebK9OZHd4mR/4Vf9UuE8ar8zwc3+CBvgMz4HvPTUTg==","signatures":[{"sig":"MEQCIA9U5AYjwSz99e7HkM62H8S1qZZttrEO6A6p2+led6YIAiA8/1uz4L1UScz6AttdVwkMWbvs9bGLtMJBRCm3H3pJFg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDOwx+vESTaPLLQ70BecUADsB+2CnZtB6ZVuOJJ0WZWJAIhAP3P1WVSwFcOLcFa2GiYXeToya9t03n2rkT/th5Tr3vY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16305},"gitHead":"47ee5073837a97916572d769f13d86f55d54ef00","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.5_1790209493363_0.9546298759988912","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@bacnh85/pi-references","version":"0.1.6","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.6","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"d6903c13cede7fb2895c633016ab203a8a514c6a","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.6.tgz","fileCount":5,"integrity":"sha512-81mvWYLB36VamdEeZ82cnIWoDSFg5xOVvKBaPKnEWA2mf6PHA3sIzPfnB78Xw2cXCxDlo4SBjE8MabW85w8ZIQ==","signatures":[{"sig":"MEYCIQCxE5tzKgnbM4l4vgiQYW8gC/7/mXDoGR1g35UYf9TDtwIhAPPhagetHh497w3TbdyZ8/9MZ5yBVAAp7z6yTabOkwhp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC7c9I8brlYFN9TCiy15NzV8QzuY3HwNx3nslEVT14fAwIgHQBzyRH5CTixWfy5rdsM7/VBuDV5MY0Zv3ETIWm6/MA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17528},"gitHead":"96408d174879a677b06eed011e02b3b0ddaafa03","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.6_1790479584848_0.16801768352113333","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@bacnh85/pi-references","version":"0.1.7","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"license":"MIT","_id":"@bacnh85/pi-references@0.1.7","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"pi":{"extensions":["./extensions/index.js"]},"dist":{"shasum":"b3d8137ded6d84080cf7d6a9b9258a24e5d52470","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.7.tgz","fileCount":5,"integrity":"sha512-ca0cIz1t+mwXiildkvaGRlVKPlUTPs/Jw82gTybGqnyw9YFChnik1Qwg6Xi8UeBOsUhr5UBnqqZgMljyywn68A==","signatures":[{"sig":"MEYCIQDF5xypKa2dIqaE9alOAFImtwQhFqgkyOTQS+4UNOlAdwIhAPTo3lrSsL/aCcWaR2KZloM+SErQ7RxjJBfelCMZSCcF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIAu/3BeZgoSZFV9aX+m6Gz7DLzRJJhqA9+duii5fajbXAiBnx0St0XgEI1ruekf6JU7y8BtpJcocMDhqC5frmBQl4A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18473},"gitHead":"90930b50f5fc0a4491a748ee1692db40f7ec358a","scripts":{"test":"node --test extensions/test/*.test.js"},"_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.8","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/pi-references_0.1.7_1790555390318_0.2318056312338448","host":"s3://npm-registry-packages-npm-production"}},"0.1.8":{"pi":{"extensions":["./extensions/index.js"]},"_id":"@bacnh85/pi-references@0.1.8","bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"dist":{"shasum":"0af736724230c906cdf32f15c7af62cfbecf0887","tarball":"https://registry.npmjs.org/@bacnh85/pi-references/-/pi-references-0.1.8.tgz","fileCount":5,"integrity":"sha512-E9N6u77ARTlfb1SY6hInA4rXdF4eGIL6GqJHPsYTeIqtBuF8BgMpUZzVBP+pifOOnuie7WO/CQhR6L7vYc8VNw==","signatures":[{"sig":"MEUCIQCDAgnddi2X9m30a7IyZK9xU2VI1MBM1w2pOVcHFvtBZQIgd+7TrIDDpX4CcMb9YwOXmNYZrnV5/FmlZ4V5nibbaBM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIA8VyACbWs4DoC5oWvtj6mGAy6D2eV5Z8z5WgyKhmhXLAiA1tYTF5H6pLVLnny8jhqfkx6Irsn1ZlcCXAUp751dTTQ=="}],"unpackedSize":19185},"name":"@bacnh85/pi-references","gitHead":"5388a5f1987873fe1355064f72021452c4347c72","license":"MIT","scripts":{"test":"node --test extensions/test/*.test.js"},"version":"0.1.8","_npmUser":{"name":"bacnh85","email":"mail@bacnh.com"},"homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"_npmVersion":"10.9.9","description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","directories":{},"maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"_nodeVersion":"22.23.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-references_0.1.8_1790729366193_0.8104932588548825"}}},"time":{"created":"2026-08-08T16:08:29.619Z","modified":"2026-09-30T00:49:26.503Z","0.1.0":"2026-08-08T16:08:29.896Z","0.1.1":"2026-08-11T09:00:27.366Z","0.1.2":"2026-09-12T09:13:27.999Z","0.1.3":"2026-09-20T05:10:05.628Z","0.1.4":"2026-09-21T03:51:00.049Z","0.1.5":"2026-09-24T00:24:53.447Z","0.1.6":"2026-09-27T03:26:24.927Z","0.1.7":"2026-09-28T00:29:50.397Z","0.1.8":"2026-09-30T00:49:26.277Z"},"bugs":{"url":"https://github.com/bacnh85/pi-extensions/issues"},"license":"MIT","homepage":"https://github.com/bacnh85/pi-extensions/tree/main/pi-references","keywords":["pi-package","pi","references","context","external","monorepo","docs","sdk"],"repository":{"url":"git+https://github.com/bacnh85/pi-extensions.git","type":"git"},"description":"External context roots for Pi — alias sibling dirs or git repos as @docs, @sdk and reference them in chat. Auto-clones git repos into a local cache; injects descriptions into agent context. Inspired by OpenCode's references feature.","maintainers":[{"name":"bacnh85","email":"mail@bacnh.com"}],"readme":"# pi-references\n\nExternal context roots for [Pi](https://pi.dev).\n\nAlias sibling directories or git repositories as `@docs`, `@sdk`, etc., and reference them by name. Local refs resolve at startup; git refs are cloned into a local cache at session start. References with a `description` are injected into the agent's system prompt so the model knows they exist. Inspired by OpenCode's `references` feature.\n\n## Install\n\n```bash\npi install npm:@bacnh85/pi-references\n```\n\n## Configuration\n\nAdd a `references` object to `.pi/settings.json` (project), `~/.pi/agent/settings.json` (global; `PI_CODING_AGENT_DIR` overrides), or `~/.pi/agents/settings.json` — the first settings.json containing a `references` object wins (files without one are skipped):\n\n```json\n{\n  \"references\": {\n    \"docs\": {\n      \"path\": \"../product-docs\",\n      \"description\": \"Use for product behavior and documentation conventions\"\n    },\n    \"sdk\": {\n      \"repository\": \"owner/opencode-sdk-js\",\n      \"branch\": \"main\",\n      \"description\": \"Use for JavaScript SDK implementation details\"\n    }\n  }\n}\n```\n\n### Fields\n\n| Field | Local | Git | Description |\n|-------|:-----:|:---:|-------------|\n| `path` | ✅ | — | Local reference directory (relative or absolute) |\n| `repository` | — | ✅ | Git URL, `host/path`, or GitHub `owner/repo` |\n| `branch` | — | ✅ | Optional branch/ref (defaults to repo default) |\n| `description` | ✅ | ✅ | When to use the reference (advertised to the agent) |\n| `hidden` | ✅ | ✅ | Hide from the agent: excluded from the system-prompt advertisement even when a `description` is set |\n\n### Shorthand\n\nString values are parsed automatically:\n\n```json\n{\n  \"references\": {\n    \"docs\": \"../docs\",\n    \"sdk\": \"owner/repo\"\n  }\n}\n```\n\n## Command\n\n| Command | Description |\n|---------|-------------|\n| `/refs` | List configured references and their resolved paths |\n\n## How it works\n\n1. On `session_start`, resolves local paths against the project cwd and ensures git refs are cloned into `~/.pi/agent/refs/<alias>/` (eager, best-effort, non-blocking).\n2. On every `before_agent_start`, appends the reference list (those with descriptions) to the system prompt so the model can read files under those roots when relevant.\n3. The `/refs` command lists what's configured and where it resolved.\n\n## Alias rules\n\nReference aliases cannot be empty or contain `/`, whitespace, backticks, or commas.\nDot segments are rejected: an alias of `.` or `..` is dropped (line ~107 of\n`extensions/index.js`), since `join(cacheRoot, \"..\")` would resolve the ref\noutside the cache root entirely.\nBranch names starting with `-` are dropped: a dashed branch in a repo ref\n(line ~190) could be parsed by `git clone` as an option (argument injection\nfrom config), so a branch like `-x` is silently not passed as `--branch`.\n\n## Why\n\nCross-repo work — referencing a sibling project, an SDK, upstream docs — is common but friction-heavy in Pi (manual `@../path` or copying). `pi-references` makes external context roots first-class and discoverable to the agent.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}