# pi-readseek

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

Latest version **0.12.6** (published 2026-10-29) · 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 65/100 (B)** — status: active.

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

Warnings: no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.12.6 |
| Published | 2026-10-29 |
| First published | 2026-06-11 |
| Weekly downloads | 3.7K |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| 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

## 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.12.6 (latest) — 2026-10-29
- 0.12.5 — 2026-10-27
- 0.12.4 — 2026-10-26
- 0.12.3 — 2026-10-26
- 0.12.2 — 2026-10-26
- 0.12.1 — 2026-10-25
- 0.12.0 — 2026-10-23
- 0.11.4 — 2026-10-22
- 0.11.3 — 2026-10-21
- 0.11.2 — 2026-10-19
- 0.11.1 — 2026-10-18
- 0.11.0 — 2026-10-15
- 0.10.7 — 2026-10-12
- 0.10.6 — 2026-10-11
- 0.10.5 — 2026-10-10
- … 152 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 AppImage on Linux (without FUSE) and native executables on
macOS/Windows supplied by `@jarkkojs/readseek`. Set
`READSEEK_BINARY` to an absolute executable path to override it.

## Tools

`readSeek_show`, `readSeek_tree`, `readSeek_meta`,
`readSeek_assets`, `readSeek_grep`, `readSeek_search`,
`readSeek_def`, `readSeek_refs`, `readSeek_syntax`,
`readSeek_check`, `readSeek_caption`, `readSeek_objects`,
`readSeek_ocr`, `readSeek_edit`, `readSeek_rename`, and
`readSeek_write`.

Document content includes cached image paths; capable host models receive image
attachments without a separate extraction call. Reading never runs local inference;
captioning, detection, and OCR require their explicit tools. Legacy tool names and
selectable inspection facets are removed.

Image attachments share a 32 MiB base64-data budget per tool result. Images that
would exceed the remaining budget are omitted with a notice and their file path;
smaller images later in the result can still be attached.

The four `show` tools display readable summaries and grouped details rather than
JSON dumps. Expand with Ctrl+O to reveal content; long lines wrap on resize.
Source anchors, selected document nodes, asset paths, and continuation notices
remain visible. Native results are retained in tool-result details.

## 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`; `off` disables image attachments, while `auto` and `on`
attach images only when the host supports them. None enables automatic inference.
`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._
