opencode-gitbutler 0.1.0 → 0.1.2
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 +40 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,13 +1,52 @@
|
|
|
1
1
|
# opencode-gitbutler
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/opencode-gitbutler)
|
|
4
|
+
|
|
5
|
+
Stop managing git branches manually and let your AI agents do the heavy lifting with GitButler.
|
|
6
|
+
|
|
7
|
+
## Why This Plugin?
|
|
8
|
+
|
|
9
|
+
AI agents generate code at a pace that manual version control can't match. Without automation, you end up with massive commits, messy branch organization, and generic messages that make code review a nightmare.
|
|
10
|
+
|
|
11
|
+
This plugin bridges the gap by bringing GitButler's virtual branch power directly into your OpenCode agent sessions.
|
|
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
|
+
### What This Plugin Does Differently
|
|
26
|
+
|
|
27
|
+
- Only tool that combines automatic branch creation, LLM commits, file assignment, and context injection.
|
|
28
|
+
- Zero-config setup. Just run `bun add` and add it to your plugins.
|
|
29
|
+
- Works with GitButler virtual branches to avoid worktree overhead.
|
|
30
|
+
- Impersonates Cursor for full GitButler CLI compatibility.
|
|
31
|
+
- Unique multi-agent session mapping.
|
|
32
|
+
- Hunk-level rub guard to skip multi-stack files.
|
|
4
33
|
|
|
5
34
|
## Installation
|
|
6
35
|
|
|
36
|
+
Install the package from npm:
|
|
37
|
+
|
|
7
38
|
```bash
|
|
8
39
|
bun add opencode-gitbutler
|
|
9
40
|
```
|
|
10
41
|
|
|
42
|
+
Or add it to your plugins array in `.opencode/config.json`:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"plugins": ["opencode-gitbutler"]
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
11
50
|
## Prerequisites
|
|
12
51
|
|
|
13
52
|
- **GitButler CLI** (`but`) — [Install via Homebrew](https://docs.gitbutler.com/installation)
|