trq-pi-colgrep

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# @trq/pi-colgrep

A pi extension package that adds a dedicated `colgrep` tool for semantic/hybrid code search using [ColGrep](https://github.com/lightonai/next-plaid/tree/main/colgrep).

Background reading: [LateOn-Code & ColGrep announcement](https://huggingface.co/blog/lightonai/colgrep-lateon-code).

## 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:

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

## Install (pi package)

```bash
pi install npm:@trq/pi-colgrep
```

Or project-local:

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

## Local development

```bash
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

```bash
npm publish --access public
```

@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