pi-readseek0.11.2
Pi extension for LINE:HASH-anchored file operations and structural code navigation
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
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 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_content, readSeek_show_structure, readSeek_show_metadata,
readSeek_show_assets, readSeek_find_text, readSeek_find_nodes,
readSeek_find_definitions, readSeek_find_references, readSeek_check_syntax,
readSeek_check_rules, readSeek_generate_caption, readSeek_detect_objects,
readSeek_recognize_text, readSeek_edit_text, readSeek_rename_symbol, and
readSeek_write_file.
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.
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:
{
"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
npm install
npm test
npm run typecheck
Licensing
pi-readseek is licensed under the Apache 2.0 license. See LICENSE
for more information.