opencode-gitbutler 0.1.2 → 0.1.4
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 +13 -33
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,22 +10,10 @@ AI agents generate code at a pace that manual version control can't match. Witho
|
|
|
10
10
|
|
|
11
11
|
This plugin bridges the gap by bringing GitButler's virtual branch power directly into your OpenCode agent sessions.
|
|
12
12
|
|
|
13
|
-
### Comparison Table
|
|
14
|
-
|
|
15
|
-
| Tool | Auto Branch Creation | LLM Commit Messages | File-to-Branch Assignment | Agent Context Injection | Zero Config |
|
|
16
|
-
|------|---------------------|--------------------|--------------------------|-----------------------|-------------|
|
|
17
|
-
| **opencode-gitbutler** | Yes | Yes (Claude Haiku) | Yes (`but rub`) | Yes (SKILL.md) | Yes |
|
|
18
|
-
| GitButler Native Hooks | No | No | No | No | No (manual hook setup) |
|
|
19
|
-
| GitButler MCP Server | No (agent must call tools) | No | No | No | No (MCP config) |
|
|
20
|
-
| GitButler Code Agent | Yes (GUI only) | No | Yes (GUI) | No | No (requires Desktop app) |
|
|
21
|
-
| oh-my-opencode | No | No | No | No | N/A (different purpose) |
|
|
22
|
-
| GitKraken AI | No | Yes | No | No | No (commercial GUI) |
|
|
23
|
-
| Manual git workflow | No | No | No | No | N/A |
|
|
24
|
-
|
|
25
13
|
### What This Plugin Does Differently
|
|
26
14
|
|
|
27
15
|
- Only tool that combines automatic branch creation, LLM commits, file assignment, and context injection.
|
|
28
|
-
- Zero-config setup. Just
|
|
16
|
+
- Zero-config setup. Just add it to your plugins and go.
|
|
29
17
|
- Works with GitButler virtual branches to avoid worktree overhead.
|
|
30
18
|
- Impersonates Cursor for full GitButler CLI compatibility.
|
|
31
19
|
- Unique multi-agent session mapping.
|
|
@@ -33,37 +21,29 @@ This plugin bridges the gap by bringing GitButler's virtual branch power directl
|
|
|
33
21
|
|
|
34
22
|
## Installation
|
|
35
23
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
bun add opencode-gitbutler
|
|
40
|
-
```
|
|
24
|
+
### 1. Add plugin to OpenCode config
|
|
41
25
|
|
|
42
|
-
|
|
26
|
+
Add to your `opencode.json` (global or project-level):
|
|
43
27
|
|
|
44
28
|
```json
|
|
45
29
|
{
|
|
46
|
-
"
|
|
30
|
+
"plugin": [
|
|
31
|
+
"opencode-gitbutler@latest"
|
|
32
|
+
]
|
|
47
33
|
}
|
|
48
34
|
```
|
|
49
35
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
- **GitButler CLI** (`but`) — [Install via Homebrew](https://docs.gitbutler.com/installation)
|
|
53
|
-
- **OpenCode** — v1.1.0 or later
|
|
54
|
-
- **Bun** — v1.0.0 or later (plugin runtime)
|
|
36
|
+
OpenCode will install the plugin automatically on next launch.
|
|
55
37
|
|
|
56
|
-
|
|
38
|
+
### 2. Install GitButler CLI
|
|
57
39
|
|
|
58
|
-
|
|
40
|
+
```bash
|
|
41
|
+
brew install gitbutler
|
|
42
|
+
```
|
|
59
43
|
|
|
60
|
-
|
|
44
|
+
See [GitButler installation docs](https://docs.gitbutler.com/installation) for other methods.
|
|
61
45
|
|
|
62
|
-
|
|
63
|
-
{
|
|
64
|
-
"plugins": ["opencode-gitbutler"]
|
|
65
|
-
}
|
|
66
|
-
```
|
|
46
|
+
### 3. Restart OpenCode
|
|
67
47
|
|
|
68
48
|
The plugin automatically:
|
|
69
49
|
- Creates and renames branches based on your prompts
|