pi-semble

Pi extension that exposes Semble code search as a tool.

Packages

Package details

extension

Install pi-semble from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-semble
Package
pi-semble
Version
0.1.1
Published
May 18, 2026
Downloads
not available
Author
hoverflow
License
MIT
Types
extension
Size
7.6 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-semble

Pi extension that exposes Semble as a native Pi tool.

Author: Jonathan Stevano

Policy: prefer Semble before grep/find; fall back to built-ins only when Semble is insufficient or the user needs exhaustive literal matching.

Install

pi install npm:pi-semble

Requirements

  • uv / uvx installed locally
  • Semble is fetched on demand via uvx --from "semble[mcp]" semble

Tool

semble

Arguments:

  • action: search | find_related
  • repo: local path or git URL (defaults to current project directory)
  • top_k: number of results
  • include_text_files: also index text files

Examples:

Find where auth is implemented

Semble should be the first search step; use grep/find only if Semble returns nothing useful.

{"action":"search","query":"auth flow","repo":"."}

{"action":"find_related","file_path":"src/auth.ts","line":42,"repo":"."}