@mesadev/agentblame 3.1.3 → 3.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.
Files changed (2) hide show
  1. package/README.md +58 -66
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,11 @@
1
- # Agent Blame
1
+ # Agent Blame CLI
2
2
 
3
- Track AI-generated vs human-written code. Know what the AI wrote and focus your code reviews where it matters.
3
+ **Know what the AI wrote. Focus your code reviews where it matters.**
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@mesadev/agentblame)](https://www.npmjs.com/package/@mesadev/agentblame)
6
+ [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/mesa-dot-dev/agentblame/blob/main/LICENSE)
7
+
8
+ Track AI-generated vs human-written code in your Git history. Works with Cursor, Claude Code, and OpenCode.
4
9
 
5
10
  ## Prerequisites
6
11
 
@@ -13,19 +18,7 @@ Track AI-generated vs human-written code. Know what the AI wrote and focus your
13
18
  curl -fsSL https://bun.sh/install | bash
14
19
  ```
15
20
 
16
- ## Installation
17
-
18
- Use with bunx (recommended):
19
- ```bash
20
- bunx @mesadev/agentblame@latest <command>
21
- ```
22
-
23
- Or install globally:
24
- ```bash
25
- npm install -g @mesadev/agentblame
26
- ```
27
-
28
- ## Setup
21
+ ## Quick Start
29
22
 
30
23
  ### 1. One-Time Machine Setup
31
24
 
@@ -41,47 +34,24 @@ In each git repository you want to track:
41
34
  bunx @mesadev/agentblame@latest init
42
35
  ```
43
36
 
44
- This sets up:
37
+ This sets up everything automatically:
45
38
  - Editor hooks for Cursor, Claude Code, and OpenCode
46
39
  - Git post-commit hook for attribution capture
47
40
  - GitHub Actions workflow for squash/merge support
48
41
 
49
- **Note:** Restart your editor after running init.
42
+ > **Important:** Restart your editor after running init.
50
43
 
51
- ## Usage
52
-
53
- 1. Make AI edits in Cursor, Claude Code, or OpenCode
54
- 2. Commit your changes (attribution attached automatically)
55
- ```bash
56
- git commit -m "new python file"
57
- ```
58
- ```
59
- ┌──────────────────────────────────────────────────────────────────────┐
60
- │ Agent Blame v3 │
61
- ├──────────────────────────────────────────────────────────────────────┤
62
- │ Commit: 7bdf773b │
63
- │ Files: 1 │
64
- ├──────────────────────────────────────────────────────────────────────┤
65
- │ Sessions: │
66
- │ b4deb96e [cursor - gpt-5.2-codex] │
67
- │ [P13] "Add a new file hello_world.py in python and a..." │
68
- ├──────────────────────────────────────────────────────────────────────┤
69
- │ Summary: │
70
- │ ██████████████████████████████████████████████████ │
71
- │ AI: 2 lines (100%) Human: 0 lines ( 0%) │
72
- └──────────────────────────────────────────────────────────────────────┘
73
- ```
44
+ ### 3. View Attribution
74
45
 
75
- 3. View attribution:
46
+ Make AI edits, commit, then view attribution:
76
47
 
77
48
  ```bash
78
- agentblame blame <file>
49
+ bunx @mesadev/agentblame@latest blame src/auth.ts
79
50
  ```
80
51
 
81
- ### Example Output
82
-
52
+ Example output:
83
53
  ```
84
- python/hello_world.py
54
+ src/auth.ts
85
55
  ──────────────────────────────────────────────────────────────────────
86
56
  Prompts:
87
57
  [P1] Cursor (gpt-5.2-codex)
@@ -95,46 +65,68 @@ agentblame blame <file>
95
65
  AI: 2 lines (100%) │ Human: 0 lines (0%)
96
66
  ```
97
67
 
98
- ## CLI Commands
68
+ ## CLI Reference
99
69
 
100
- ```bash
101
- agentblame setup # One-time machine setup (creates ~/.agentblame database)
102
- agentblame init # Set up hooks and workflow for current repo
103
- agentblame clean # Remove hooks from current repo
104
- agentblame blame <file> # Show AI attribution
105
- agentblame sync # Transfer notes after squash/rebase
106
- agentblame config # Show/set configuration
107
- agentblame debug # Show detailed debug info
108
- ```
70
+ | Command | Description |
71
+ |---------|-------------|
72
+ | `bunx @mesadev/agentblame@latest setup` | One-time machine setup (creates ~/.agentblame database) |
73
+ | `bunx @mesadev/agentblame@latest init` | Set up hooks and GitHub Actions workflow for a repo |
74
+ | `bunx @mesadev/agentblame@latest clean` | Remove hooks from current repo |
75
+ | `bunx @mesadev/agentblame@latest blame <file>` | Show AI attribution for a file |
76
+ | `bunx @mesadev/agentblame@latest sync` | Transfer notes after squash/rebase |
77
+ | `bunx @mesadev/agentblame@latest config` | Show/set configuration |
78
+ | `bunx @mesadev/agentblame@latest debug` | Show detailed debug info |
109
79
 
110
- ### Examples
80
+ ### Configuration
111
81
 
112
82
  ```bash
113
- bunx @mesadev/agentblame@latest setup
114
- bunx @mesadev/agentblame@latest init
115
- bunx @mesadev/agentblame@latest blame src/index.ts
116
- bunx @mesadev/agentblame@latest config set storePromptContent true
83
+ # Show current config
84
+ bunx @mesadev/agentblame@latest config
85
+
86
+ # Disable prompt content storage (enabled by default)
87
+ bunx @mesadev/agentblame@latest config storePromptContent false
117
88
  ```
118
89
 
119
- ## Chrome Extension
90
+ ## How It Works
120
91
 
121
- See AI markers on GitHub PRs with our Chrome extension.
92
+ ```
93
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
94
+ │ Cursor/Claude │────▶│ Git Hooks │────▶│ Database │
95
+ │ Code edits │ │ capture edits │ │ stores pending │
96
+ └─────────────────┘ └─────────────────┘ └─────────────────┘
97
+ │
98
+ ▼
99
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
100
+ │ CLI/Extension │◀────│ Git Notes │◀────│ Git Commit │
101
+ │ show markers │ │ store metadata │ │ triggers match │
102
+ └─────────────────┘ └─────────────────┘ └─────────────────┘
103
+ ```
122
104
 
123
- Get it from the [Chrome Web Store](https://chromewebstore.google.com/detail/agent-blame/ofldnnppeiicgpmpgkbmipbcnhnbgccp) or the [GitHub repository](https://github.com/mesa-dot-dev/agentblame#chrome-extension).
105
+ 1. **Hooks** intercept edits from AI coding tools
106
+ 2. **Database** stores pending attributions with content hashes
107
+ 3. **Commit** triggers matching of committed lines to pending edits
108
+ 4. **Git Notes** attach attribution metadata to commits
109
+ 5. **CLI/Extension** read notes to display markers
124
110
 
125
111
  ## Troubleshooting
126
112
 
127
113
  | Problem | Solution |
128
114
  |---------|----------|
129
115
  | Database not found | Run `bunx @mesadev/agentblame@latest setup` once on your machine |
130
- | Hooks not capturing | Restart your editor; run `agentblame debug` to check status |
116
+ | Hooks not capturing | Restart your editor; run `bunx @mesadev/agentblame@latest debug` to check status |
131
117
  | Notes not on GitHub | Run `git push origin refs/notes/agentblame` |
132
- | Squash merge lost attribution | Ensure workflow is committed; run `agentblame sync` locally |
118
+ | Squash merge lost attribution | Ensure workflow is committed; run `bunx @mesadev/agentblame@latest sync` locally |
133
119
  | Bun not found | Install Bun: `curl -fsSL https://bun.sh/install \| bash` |
134
120
 
121
+ ## Browser Extensions
122
+
123
+ See AI attribution directly on GitHub PRs:
124
+ - [Chrome Web Store](https://chromewebstore.google.com/detail/agent-blame/ofldnnppeiicgpmpgkbmipbcnhnbgccp)
125
+ - [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/agentblame/)
126
+
135
127
  ## More Information
136
128
 
137
- For full documentation, Chrome extension installation, and contributing guidelines, visit the [GitHub repository](https://github.com/mesa-dot-dev/agentblame).
129
+ For full documentation, contributing guidelines, and source code, visit the [GitHub repository](https://github.com/mesa-dot-dev/agentblame).
138
130
 
139
131
  ## License
140
132
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mesadev/agentblame",
3
- "version": "3.1.3",
3
+ "version": "3.1.4",
4
4
  "description": "CLI to track AI-generated vs human-written code",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {