pi-readseek

Pi extension for LINE:HASH-anchored file operations and structural code navigation

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-readseek

Package: pi-readseek
Version: 0.9.16
Published: Aug 31, 2026
Downloads: 6,858/mo · 821/wk
Author: jarkkojs
License: Apache-2.0
Types: extension
Size: 243.9 KB
Dependencies: 3 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./dist/index.ts"
  ]
}

Security note

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

README

pi-readseek

Pi extension for anchored file operations, structural search, symbol navigation, and document inspection.

Install

pi install npm:pi-readseek

The extension uses the native binary supplied by @jarkkojs/readseek-api. Set READSEEK_BINARY to an absolute executable path to override it.

Tools

readSeek_edit, readSeek_write, readSeek_grep, readSeek_search, readSeek_def, readSeek_refs, readSeek_rename, readSeek_digest, and readSeek_view.

Settings

Add readseek to ~/.pi/agent/settings.json or .pi/settings.json:

{
  "readseek": {
    "overrideTools": [],
    "imageMode": "auto",
    "syntaxValidation": "warn",
    "timeoutMs": 120000,
    "grep": { "maxLines": 2000, "maxBytes": 51200 },
    "display": {
      "grep": "compact",
      "edit": "expanded",
      "write": "expanded"
    }
  }
}

overrideTools accepts read, edit, write, and grep. imageMode is auto, on, or off; syntaxValidation is warn, block, or off.

Development

npm install
npm test
npm run typecheck

Licensing

pi-readseek is licensed under the Apache 2.0 license. See LICENSE for more information.