@mtayfur/opencode-chat-tree 1.0.2 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -42
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# OpenCode Chat Tree
|
|
2
2
|
|
|
3
|
-
`@mtayfur/opencode-chat-tree` adds persistent conversation branching to the OpenCode TUI. It presents related
|
|
3
|
+
`@mtayfur/opencode-chat-tree` adds persistent conversation branching to the OpenCode TUI. It presents related
|
|
4
|
+
sessions as a navigable tree, creates branches from any visible message, and can carry a generated handoff into the
|
|
5
|
+
new branch.
|
|
4
6
|
|
|
5
7
|
## Capabilities
|
|
6
8
|
|
|
@@ -16,32 +18,29 @@
|
|
|
16
18
|
## Requirements
|
|
17
19
|
|
|
18
20
|
- OpenCode `1.18.16` or newer compatible 1.x release
|
|
19
|
-
- Bun `1.3.14` or newer for local development
|
|
20
21
|
|
|
21
22
|
## Installation
|
|
22
23
|
|
|
23
|
-
|
|
24
|
+
Install the plugin globally with OpenCode:
|
|
24
25
|
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
"plugin": ["@mtayfur/opencode-chat-tree"]
|
|
28
|
-
}
|
|
26
|
+
```sh
|
|
27
|
+
opencode plugin @mtayfur/opencode-chat-tree --global
|
|
29
28
|
```
|
|
30
29
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
### Local checkout
|
|
30
|
+
Restart OpenCode after installation.
|
|
34
31
|
|
|
35
|
-
|
|
36
|
-
bash ./install.sh
|
|
37
|
-
```
|
|
32
|
+
### Manual configuration
|
|
38
33
|
|
|
39
|
-
|
|
34
|
+
Alternatively, add the package to `~/.config/opencode/tui.json`:
|
|
40
35
|
|
|
41
|
-
```
|
|
42
|
-
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"plugin": ["@mtayfur/opencode-chat-tree"]
|
|
39
|
+
}
|
|
43
40
|
```
|
|
44
41
|
|
|
42
|
+
Restart OpenCode after changing the configuration.
|
|
43
|
+
|
|
45
44
|
## Configuration
|
|
46
45
|
|
|
47
46
|
The plugin intentionally keeps its configuration small:
|
|
@@ -97,29 +96,6 @@ Controls are fixed by design. OpenCode activates them only while the tree has fo
|
|
|
97
96
|
- Global: `<OpenCode state>/plugins/opencode-chat-tree/projects/<project-slug-hash>/`
|
|
98
97
|
- Local: `<project>/.opencode/opencode-chat-tree/`
|
|
99
98
|
|
|
100
|
-
Each project has a `registry.json` and immutable-style tree snapshots under `trees/<tree-id>/snapshot.json`. Writes use
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
```text
|
|
105
|
-
src/
|
|
106
|
-
├── adapters/ OpenCode and filesystem boundaries
|
|
107
|
-
├── core/ Tree, transcript, projection, and branch rules
|
|
108
|
-
├── ui/ TUI controls, workflow, route, and rendering
|
|
109
|
-
├── configuration.ts
|
|
110
|
-
└── index.ts Plugin entrypoint
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
Core modules are side-effect free. `TreeRepository` owns persistence, while `OpenCodeTreeGateway` owns SDK calls and fork cleanup. The UI only coordinates reactive state and user interaction.
|
|
114
|
-
|
|
115
|
-
## Development
|
|
116
|
-
|
|
117
|
-
From the repository root:
|
|
118
|
-
|
|
119
|
-
```sh
|
|
120
|
-
bun install --frozen-lockfile
|
|
121
|
-
bun run --filter @mtayfur/opencode-chat-tree fmt:check
|
|
122
|
-
bun run --filter @mtayfur/opencode-chat-tree typecheck
|
|
123
|
-
bun run --filter @mtayfur/opencode-chat-tree build
|
|
124
|
-
npm pack ./packages/chat-tree --dry-run
|
|
125
|
-
```
|
|
99
|
+
Each project has a `registry.json` and immutable-style tree snapshots under `trees/<tree-id>/snapshot.json`. Writes use
|
|
100
|
+
temporary files and atomic renames. The plugin validates ownership, parent-child symmetry, graph reachability, and
|
|
101
|
+
path-safe tree IDs before using persisted data.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/package.json",
|
|
3
3
|
"name": "@mtayfur/opencode-chat-tree",
|
|
4
|
-
"version": "1.0.
|
|
4
|
+
"version": "1.0.3",
|
|
5
5
|
"description": "Conversation branching and navigation for the OpenCode TUI.",
|
|
6
6
|
"homepage": "https://github.com/mtayfur/opencode-plugins/tree/main/packages/chat-tree#readme",
|
|
7
7
|
"bugs": {
|