# pi-readseek

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

Latest version **0.9.16** (published 2026-08-31) · Apache-2.0 license · 3.7K weekly downloads

## Install

```sh
npm install pi-readseek
pnpm add pi-readseek
yarn add pi-readseek
bun add pi-readseek
```

## Health

**Score 70/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.9.16 |
| Published | 2026-08-31 |
| First published | 2026-06-11 |
| Weekly downloads | 3.7K |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM |
| Node | >=20.0.0 |
| Dependencies | 3 |
| Unpacked size | 243.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Maxwell Newman |
| Maintainers | jarkkojs |
| Keywords | pi-package, pi-extension, hashline, code-map, structural-search |

## Links

- npm: https://www.npmjs.com/package/pi-readseek
- Repository: https://gitlab.com/jarkkojs/readseek
- Homepage: https://gitlab.com/jarkkojs/readseek/-/tree/main/packages/pi-readseek#readme
- Issues: https://gitlab.com/jarkkojs/readseek/-/issues
- npm.io page: https://npm.io/package/pi-readseek

## Dependencies (3)

- [diff](https://npm.io/package/diff.md) ^9.0.0
- [xxhash-wasm](https://npm.io/package/xxhash-wasm.md) ^1.1.0
- [@jarkkojs/readseek-api](https://npm.io/package/@jarkkojs/readseek-api.md) ^0.9.16

## Alternatives

- [@gemini-wallet/core](https://npm.io/package/@gemini-wallet/core.md) — 515.6K weekly downloads
- [utility](https://npm.io/package/utility.md) — 416.6K weekly downloads
- [@primno/dpapi](https://npm.io/package/@primno/dpapi.md) — 7.2K weekly downloads
- [@emilia-protocol/verify](https://npm.io/package/@emilia-protocol/verify.md) — 1.1K weekly downloads
- [win-dpapi](https://npm.io/package/win-dpapi.md) — 872 weekly downloads

## Recent versions

- 0.9.16 (latest) — 2026-08-31
- 0.9.15 — 2026-08-23
- 0.9.14 — 2026-08-21
- 0.9.13 — 2026-08-11
- 0.9.12 — 2026-08-11
- 0.9.11 — 2026-08-11
- 0.9.10 — 2026-08-08
- 0.9.9 — 2026-08-05
- 0.9.8 — 2026-08-05
- 0.9.7 — 2026-08-04
- 0.9.6 — 2026-08-04
- 0.9.5 — 2026-08-04
- 0.9.4 — 2026-08-04
- 0.9.3 — 2026-08-03
- 0.9.2 — 2026-08-03
- … 132 more at https://npm.io/package/pi-readseek/versions

## README

# pi-readseek

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

## Install

```sh
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`:

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

```sh
npm install
npm test
npm run typecheck
```


## Licensing

`pi-readseek` is licensed under the Apache 2.0 license. See [LICENSE](LICENSE)
for more information.

---
_Source: https://npm.io/package/pi-readseek · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._