@trq/pi-colgrep

pi extension that adds a colgrep tool and prioritizes semantic/hybrid ColGrep search

Package details

extensionskill

Install @trq/pi-colgrep from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@trq/pi-colgrep
Package
@trq/pi-colgrep
Version
0.1.4
Published
Mar 10, 2026
Downloads
54/mo · 8/wk
Author
trq
License
MIT AND Apache-2.0
Types
extension, skill
Size
31.4 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/colgrep.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

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

README

@trq/pi-colgrep

A pi extension package that adds a dedicated colgrep tool for semantic/hybrid code search using ColGrep.

Background reading: LateOn-Code & ColGrep announcement.

Features

  • Adds a dedicated colgrep tool (keeps a clearer mental model than overriding grep).
  • Prefers colgrep by default by removing built-in grep from active tools when the extension loads.
  • Supports semantic queries plus optional regex pre-filter (query + regex), with compatibility for legacy pattern calls.
  • Re-indexes automatically:
    • on session start,
    • after write and edit tool changes,
    • on filesystem change events (recursive watcher where supported).
  • Adds /colgrep-reindex command for manual index refresh.
  • Ships a colgrep usage skill (skills/colgrep/SKILL.md) so agents are prompted to prefer colgrep workflows.

Prerequisites

Install colgrep first:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/lightonai/next-plaid/releases/latest/download/colgrep-installer.sh | sh

Install (pi package)

pi install npm:@trq/pi-colgrep

Or project-local:

pi install -l npm:@trq/pi-colgrep

Local development

pi -e ./extensions/colgrep.ts

Third-party content and licensing

This package includes an adapted skill from LightOn's next-plaid repository:

  • Source: colgrep/src/install/SKILL.md
  • Upstream license: Apache-2.0
  • Included license text: THIRD_PARTY_LICENSES/next-plaid-LICENSE.Apache-2.0.txt

Publish

npm publish --access public