readseek 0.5.18

structural source reader with stable line hashes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# opencode-readseek

`opencode-readseek` exposes ReadSeek's hash-anchored reads and structural code
navigation as OpenCode tools. It intentionally does not replace OpenCode's
built-in `read`, `edit`, or `write` tools.

## Installation

Add the plugin to `opencode.json`:

```json
{
  "plugin": ["opencode-readseek"]
}
```

OpenCode installs the package and its supported-platform `@jarkkojs/readseek`
binary dependency with Bun at startup.

## Tools

- `readseek_read`: read text with `LINE:HASH` anchors.
- `readseek_map`: generate a structural symbol map.
- `readseek_search`: AST-pattern search.
- `readseek_def`, `readseek_refs`, `readseek_hover`: symbol navigation.
- `readseek_rename`: generate a rename plan without writing files.
- `readseek_check`: parse diagnostics.

The plugin discards remembered anchors after OpenCode reports `file.edited`,
records anchors from successful ReadSeek tool results, refuses any attempt to
apply a rename directly, and adds current anchors plus a pending rename plan to
the OpenCode compaction context.

## Licensing

This package is Apache-2.0. `@jarkkojs/readseek` is licensed separately as
Apache-2.0 AND LGPL-2.1-or-later.