@mesadev/agentblame 3.1.11 → 3.1.12
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 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -22,16 +22,17 @@ curl -fsSL https://bun.sh/install | bash
|
|
|
22
22
|
|
|
23
23
|
### 1. One-Time Machine Setup
|
|
24
24
|
|
|
25
|
-
Run this once on your machine to create the local database:
|
|
25
|
+
Run this once on your machine to create the local database and the `ab` shorthand:
|
|
26
26
|
```bash
|
|
27
27
|
bunx @mesadev/agentblame@latest setup
|
|
28
28
|
```
|
|
29
|
+
> After setup, restart your terminal. You can now use `ab` instead of `bunx @mesadev/agentblame@latest` for all commands.
|
|
29
30
|
|
|
30
31
|
### 2. Repository Setup
|
|
31
32
|
|
|
32
33
|
In each git repository you want to track:
|
|
33
34
|
```bash
|
|
34
|
-
|
|
35
|
+
ab init
|
|
35
36
|
```
|
|
36
37
|
|
|
37
38
|
This sets up everything automatically:
|
|
@@ -39,14 +40,14 @@ This sets up everything automatically:
|
|
|
39
40
|
- Git post-commit hook for attribution capture
|
|
40
41
|
- GitHub Actions workflow for squash/merge support
|
|
41
42
|
|
|
42
|
-
> **Important:** Restart your editor after running init
|
|
43
|
+
> **Important:** Restart your editor after running `ab init`.
|
|
43
44
|
|
|
44
45
|
### 3. View Attribution
|
|
45
46
|
|
|
46
47
|
Make AI edits, commit, then view attribution:
|
|
47
48
|
|
|
48
49
|
```bash
|
|
49
|
-
|
|
50
|
+
ab blame src/auth.ts
|
|
50
51
|
```
|
|
51
52
|
|
|
52
53
|
Example output:
|
|
@@ -67,24 +68,26 @@ Example output:
|
|
|
67
68
|
|
|
68
69
|
## CLI Reference
|
|
69
70
|
|
|
71
|
+
> **First run:** `bunx @mesadev/agentblame@latest setup` — this creates the database and adds the `ab` shell alias. After restarting your terminal, use `ab` for all commands below.
|
|
72
|
+
|
|
70
73
|
| Command | Description |
|
|
71
74
|
|---------|-------------|
|
|
72
|
-
| `bunx @mesadev/agentblame@latest setup` | One-time machine setup (creates
|
|
73
|
-
| `
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
76
|
-
| `
|
|
77
|
-
| `
|
|
78
|
-
| `
|
|
75
|
+
| `bunx @mesadev/agentblame@latest setup` | One-time machine setup (creates database + `ab` alias) |
|
|
76
|
+
| `ab init` | Set up hooks and GitHub Actions workflow for a repo |
|
|
77
|
+
| `ab status` | Show tracking stats for current repo |
|
|
78
|
+
| `ab blame <file>` | Show AI attribution for a file |
|
|
79
|
+
| `ab sync` | Transfer notes after squash/rebase |
|
|
80
|
+
| `ab config` | Show/set configuration |
|
|
81
|
+
| `ab debug` | Show detailed debug info |
|
|
79
82
|
|
|
80
83
|
### Configuration
|
|
81
84
|
|
|
82
85
|
```bash
|
|
83
86
|
# Show current config
|
|
84
|
-
|
|
87
|
+
ab config
|
|
85
88
|
|
|
86
89
|
# Disable prompt content storage (enabled by default)
|
|
87
|
-
|
|
90
|
+
ab config set storePromptContent false
|
|
88
91
|
```
|
|
89
92
|
|
|
90
93
|
## How It Works
|
|
@@ -113,9 +116,9 @@ bunx @mesadev/agentblame@latest config storePromptContent false
|
|
|
113
116
|
| Problem | Solution |
|
|
114
117
|
|---------|----------|
|
|
115
118
|
| Database not found | Run `bunx @mesadev/agentblame@latest setup` once on your machine |
|
|
116
|
-
| Hooks not capturing | Restart your editor; run `
|
|
119
|
+
| Hooks not capturing | Restart your editor; run `ab debug` to check status |
|
|
117
120
|
| Notes not on GitHub | Run `git push origin refs/notes/agentblame` |
|
|
118
|
-
| Squash merge lost attribution | Ensure workflow is committed; run `
|
|
121
|
+
| Squash merge lost attribution | Ensure workflow is committed; run `ab sync` locally |
|
|
119
122
|
| Bun not found | Install Bun: `curl -fsSL https://bun.sh/install \| bash` |
|
|
120
123
|
|
|
121
124
|
## Browser Extensions
|