Pi Mention Project

Use short #project mentions while typing in Pi; submitted messages show the matching absolute project path.

#pi-tweaks update the package README

Type #pi-tweaks and select the project from autocomplete. When submitted, the visible message and the model context use the matching path, such as /home/you/Projects/pi-tweaks.

Install

pi install npm:@zigai/pi-mention-project

Usage

• Type # to fuzzy-search configured project folders.
• Pick a project to insert a mention such as #pi-tweaks.
• Submitting the message replaces known mentions with their absolute paths.
• Use quoted mentions for names with spaces, such as #"My Project".
• Unknown mentions stay unchanged.

Configuration

Global settings are stored in ~/.pi/agent/extension-settings/pi-mention-project.json.

| Option | Type | Default | Description | | --- | --- | --- | --- | | trigger | string | "#" | Single character that starts a project mention. | | roots | string[] | string | [] | Project root directory or directories searched for projects. | | gitReposOnly | boolean | true | Include only directories containing Git repositories. | | includeDotFolders | boolean | false | Include project directories whose names start with a dot. | | completionSuffix | string | " " | Text inserted after a completed project mention. |

{
  "$schema": "./schemas/pi-mention-project.schema.json",
  "trigger": "#",
  "roots": [],
  "gitReposOnly": true,
  "includeDotFolders": false,
  "completionSuffix": " "
}

License

MIT