@zigai/pi-mention-project

Pi package that adds fuzzy project directory mentions.

Packages

Package details

extension

Install @zigai/pi-mention-project from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@zigai/pi-mention-project
Package
@zigai/pi-mention-project
Version
0.4.1
Published
Jul 8, 2026
Downloads
877/mo · 489/wk
Author
zigai
License
MIT
Types
extension
Size
44.5 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Mention Project

npm version npm downloads license

Use short #project mentions in Pi while the model receives the matching absolute project path.

#pi-tweaks update the package README

Your chat stays readable with #pi-tweaks. Before each model request, matching project mentions in current and past user messages expand to paths 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.
  • Use quoted mentions for names with spaces, such as #"My Project".
  • Unknown mentions stay unchanged.

Configuration

Configure global settings at ~/.pi/agent/pi-mention-project/config.json.

Option Type Default Description
trigger string "#" Single non-whitespace mention character. It cannot be /.
roots string | string[] [] Project search roots.
gitReposOnly boolean true Lists only folders that are Git repos.
includeDotFolders boolean false Includes folders whose names start with ..
completionSuffix string " " Text inserted after a selected mention. Use "" for no suffix. 
{
  "$schema": "./config.schema.json",
  "trigger": "#",
  "roots": [],
  "gitReposOnly": true,
  "includeDotFolders": false,
  "completionSuffix": " "
}

License

MIT