pi-readseek

Pi extension for readseek-backed hash-anchored read/edit/grep, structural code maps, structural search, and file exploration

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-readseek
Package
pi-readseek
Version
0.3.11
Published
Jun 15, 2026
Downloads
1,215/mo · 1,215/wk
Author
jarkkojs
License
MIT
Types
extension
Size
308 KB
Dependencies
7 dependencies · 3 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-readseek

pi-readseek is a pi extension for readseek-backed file reading, hash-anchored editing, anchored grep, structural maps, symbol lookup, and structural search. It resolves conflicts between overlapping pi file-operation tools by exposing one consistent readseek-centered surface.

Installation

pi install npm:pi-readseek

The structural search and map features require the @jarkkojs/readseek native binary. The extension auto-installs the correct platform package, or you can install it manually:

# Auto-installed by the extension on supported platforms.
# Manual install (if needed):
npm install --save-dev @jarkkojs/readseek

Tools

  • read — reads text files with LINE:HASH anchors for later edit calls; images are returned as attachments. Supports symbol, map, and bundle options powered by @jarkkojs/readseek.
  • edit — changes existing text files using fresh anchors from read, grep, search, or write. Variants: set_line, replace_lines, insert_after, replace_symbol, replace. Set new_text to "" to delete a line.
  • grep — searches text and returns edit-ready LINE:HASH anchors without a follow-up read.
  • search — searches code by structural pattern (AST) and returns anchored matches. Use when syntax matters more than raw text.
  • write — creates or overwrites whole files and returns anchors for immediate follow-up edits.

Related

  • readseek.vim — Vim 9 plugin frontend for the readseek CLI. Provides go-to-definition, references, rename, hover, and structural search from within Vim.

Licensing

pi-readseek is licensed under MIT. See LICENSE for more information.

The upstream @jarkkojs/readseek packages are licensed separately as Apache-2.0 AND LGPL-2.1-or-later.

readseek is originally derived from the source code of pi-hashline-readmap. The relevant copyrights have been retained in LICENSE.