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