Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,15 @@ This changelog is automatically generated by AI when releases are published.

## [Unreleased]

## [3.12.0] - 2026-11-15

### Fixed

- **Notes that spell the overwritten-line counter `overridden_lines` are read.** Schema 3.x shipped the counter as `overriden_lines` (a typo the spec records as erratum E-001). autter now reads either spelling, and a note that carries both, in prompt records, session stats and per-file stats; when both are present the corrected spelling wins. It still writes only `overriden_lines`, so notes are byte for byte what 3.11.0 wrote, every integrity stamp stays valid, and an older autter that rewrites a note (rebase, amend) keeps the count. A later release will write both keys once every reader in the field accepts the new one; schema 4 drops the old key. The spec's E-001 now says what readers and writers must do until then. The VS Code extension's type lists both keys.
- **`autter config telemetry_oss` reads the setting back.** `autter config set telemetry_oss on|off` worked, but reading it failed with "Unknown config key". It now prints `"on"` or `"off"` (off until you opt in), and `autter config` lists it.
- **Links to docs pages that do not exist.** The `untracked` link in `autter stats` now opens the commit stats page, the agent-format error links to the "Add your agent" guide, and the README, npm README, spec and `data-privacy.md` point at pages and anchors that exist on `autter.dev/docs` (`docs.autter.dev` does not resolve).
- **The IntelliJ plugin's install hint uses the real install URL** (`https://api.autter.dev/install.sh`).

## [3.11.0] - 2026-11-15

### Changed
Expand Down
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ resolver = "3"

[package]
name = "autter"
version = "3.11.0"
version = "3.12.0"
edition = "2024"
default-run = "autter"

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ You can also disable it by setting `"telemetry_oss": "off"` in `~/.autter/config
![Junie](https://img.shields.io/badge/Junie-555?style=for-the-badge)
![Rovo Dev](https://img.shields.io/badge/Rovo_Dev-555?style=for-the-badge)
![Firebender](https://img.shields.io/badge/Firebender-555?style=for-the-badge)
[![+ Add an Agent](https://img.shields.io/badge/+_Add_an_Agent-1f6feb?style=for-the-badge)](https://autter.dev/docs/cli/add-your-agent)
[![+ Add an Agent](https://img.shields.io/badge/+_Add_an_Agent-1f6feb?style=for-the-badge)](https://autter.dev/docs/guides/add-your-agent)

## Why Autter

Expand All @@ -175,14 +175,14 @@ Want a closer look?

### Documentation

- [CI Actions](https://autter.dev/docs/guides/ci-workflows) — preserve attribution through Rebase and Merge and Squash and Merge.
- [CI Actions](https://autter.dev/docs/cli/command-reference#ci) — preserve attribution through Rebase and Merge and Squash and Merge.
- [How Autter Works](https://autter.dev/docs/cli/how-autter-works)
- [Stats command](https://autter.dev/docs/cli/commit-stats) — aggregate % AI stats across commits.
- [Scripting and CI](docs/scripting.md) — `--json` output, exit codes, `--strict`, and a GitHub Actions example.
- [AI Blame](https://autter.dev/docs/cli/ai-blame)
- [Config](https://autter.dev/docs/cli/configuration)
- [Add support for an agent in Autter](https://autter.dev/docs/guides/add-your-agent)
- Install Autter in background agents: [Claude Web](https://autter.dev/docs/cli/claude-web), [Codex Cloud](https://autter.dev/docs/cli/codex-cloud), [Cursor Agent](https://autter.dev/docs/cli/cursor-agent), and [Devin](https://autter.dev/docs/cli/devin).
- Install Autter in background agents (Claude Code on the web, Codex Cloud, Cursor background agents, Devin): run the [install script](https://autter.dev/docs/cli/install) in the agent environment's setup step. There are no agent-specific guides yet.

## Attribution Stats

Expand All @@ -193,7 +193,7 @@ autter stats --json
autter stats <start_sha>..<end_sha> --json
```

It computes % AI code, AI lines generated vs committed, acceptance rates, and human overrides, broken down by tool and model. More in the [stats command reference](https://autter.dev/docs/cli/reference#stats).
It computes % AI code, AI lines generated vs committed, acceptance rates, and human overrides, broken down by tool and model. More in the [stats command reference](https://autter.dev/docs/cli/commit-stats).

### Scripting and CI

Expand Down Expand Up @@ -361,7 +361,7 @@ Here is the full breakdown of what is supported today:
| Edit / Write / Patch tools | ✅ | Line-level attribution recorded automatically. |
| Files created via Bash | ✅ | May not work if the agent is not operating from the repository root. |
| Git worktrees | ✅ | Attribution maintained across linked worktrees. |
| Background Agents | ✅ | See docs for [Claude Web](https://autter.dev/docs/cli/claude-web), [Codex Cloud](https://autter.dev/docs/cli/codex-cloud), [Cursor Agent](https://autter.dev/docs/cli/cursor-agent), and [Devin](https://autter.dev/docs/cli/devin). |
| Background Agents | ✅ | Run the [install script](https://autter.dev/docs/cli/install) in the agent environment's setup step. |
| Attribute lines from multiple Agent Sessions in the same commit | ✅ | |
| Record which lines a human overrode | ✅ | |
| Attribute sessions that produced no code | ✅ | Records token usage and session activity even when no code is accepted. |
Expand Down Expand Up @@ -396,8 +396,8 @@ GitHub, GitLab, Bitbucket, Azure DevOps:

| Capability | Status | Notes |
| --------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------- |
| Squash and Merge | ✅ | Requires [Autter for Teams](https://cal.com/sagnik-autter/15min) or [Open Source CI Actions](https://autter.dev/docs/guides/ci-workflows) to preserve attribution. |
| Rebase and Merge | ✅ | Requires [Autter for Teams](https://cal.com/sagnik-autter/15min) or [Open Source CI Actions](https://autter.dev/docs/guides/ci-workflows) to preserve attribution. |
| Squash and Merge | ✅ | Requires [Autter for Teams](https://cal.com/sagnik-autter/15min) or [Open Source CI Actions](https://autter.dev/docs/cli/command-reference#ci) to preserve attribution. |
| Rebase and Merge | ✅ | Requires [Autter for Teams](https://cal.com/sagnik-autter/15min) or [Open Source CI Actions](https://autter.dev/docs/cli/command-reference#ci) to preserve attribution. |

## Acknowledgments

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -190,7 +190,7 @@ class AutterService {

To fix: Install autter using one of these methods:
- cargo install autter
- curl -fsSL https://install.autter.dev | sh
- curl -fsSL https://api.autter.dev/install.sh | bash
- Or ensure autter is in your PATH
""".trimIndent())
TelemetryService.getInstanceOrNull()?.reportAutterNotFound(
Expand Down
3 changes: 3 additions & 0 deletions agent-support/vscode/src/blame-service.ts
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,10 @@ export interface PromptRecord {
total_additions?: number;
total_deletions?: number;
accepted_lines?: number;
/** Schema 3.x spelling (erratum E-001); autter still writes this key. */
overriden_lines?: number;
/** Corrected spelling; later notes may carry it. Read it first: `overridden_lines ?? overriden_lines`. */
overridden_lines?: number;
other_files?: string[];
commits?: string[];
messages_url?: string;
Expand Down
6 changes: 3 additions & 3 deletions data-privacy.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Unless you choose connected mode (`autter onboard --connect`, or "Connected" in

Before you finish `autter onboard`, Autter does not read your AI agents' session history, and plain commands such as `autter status` or `autter doctor` do not start the background service.

The only other data Autter can send is anonymous error and usage telemetry. It is off until you opt in during `autter onboard` or with `autter telemetry on`, and you can turn it off at any time by setting `telemetry_oss` to `off`. See [configuration options](https://autter.dev/docs/cli/configuration#configuration-options) for details.
The only other data Autter can send is anonymous error and usage telemetry. It is off until you opt in during `autter onboard` or with `autter telemetry on`, and you can turn it off at any time by setting `telemetry_oss` to `off`. See [configuration options](https://autter.dev/docs/cli/configuration#storage-and-privacy-options) for details.

## Data

Expand All @@ -24,7 +24,7 @@ AI attribution data is written to git notes and is readable by anyone with repo

### Telemetry

- **Error & exception telemetry** — off until you opt in during `autter onboard` (or with `autter telemetry on`), in local and connected mode alike. It never includes code or prompts. You can turn it off or redirect it to your own endpoint. See [configuration options](https://autter.dev/docs/cli/configuration#configuration-options).
- **Error & exception telemetry** — off until you opt in during `autter onboard` (or with `autter telemetry on`), in local and connected mode alike. It never includes code or prompts. You can turn it off or redirect it to your own endpoint. See [configuration options](https://autter.dev/docs/cli/configuration#storage-and-privacy-options).

---

Expand Down Expand Up @@ -54,7 +54,7 @@ Teams and Enterprise deployments store additional data in the team instance:
- **SCM PR data** from GitHub, Bitbucket, and GitLab
- PR metadata: description, opener, reviewer, status
- PR diffs — processed for computing % AI code, but not stored
- **Error & exception telemetry** — off until you opt in; you can turn it off or redirect it to your own endpoint at any time. See [configuration options](https://autter.dev/docs/cli/configuration#configuration-options).
- **Error & exception telemetry** — off until you opt in; you can turn it off or redirect it to your own endpoint at any time. See [configuration options](https://autter.dev/docs/cli/configuration#storage-and-privacy-options).

For more information, see our [Trust Center](https://trust.autter.dev).

Expand Down
2 changes: 1 addition & 1 deletion docs/unsupported-agents.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,4 +136,4 @@ vendor's documentation. A miss only means no warning.
| Aider | A hook around its edit step; today its commits arrive as ordinary git commits |

To ask for an integration, or to contribute one, see
https://autter.dev/docs/cli/add-your-agent.
https://autter.dev/docs/guides/add-your-agent.
6 changes: 3 additions & 3 deletions npm/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**[Autter](https://autter.dev) is an open source git extension that records which lines of your code were written by AI** — tied to the agent, model, and prompt that produced them.

This package is a thin bootstrapper: it downloads the official native `autter` binary for your platform (macOS, Linux, or Windows; x64 or arm64) into `~/.autter/bin`, verifies its checksum against the GitHub release, and exposes the `autter` command through your npm global bin. The binary location is shared with the [shell installers](https://docs.autter.dev/cli/install), so hooks and the background service's self-updates keep working no matter how autter was installed.
This package is a thin bootstrapper: it downloads the official native `autter` binary for your platform (macOS, Linux, or Windows; x64 or arm64) into `~/.autter/bin`, verifies its checksum against the GitHub release, and exposes the `autter` command through your npm global bin. The binary location is shared with the [shell installers](https://autter.dev/docs/cli/install), so hooks and the background service's self-updates keep working no matter how autter was installed.

## Install

Expand Down Expand Up @@ -38,6 +38,6 @@ If your package manager skips install scripts (`--ignore-scripts`, pnpm, or an n

## Links

- [Documentation](https://docs.autter.dev)
- [Documentation](https://autter.dev/docs)
- [GitHub repository](https://github.com/Autter-dev/autter-cli)
- [Other install methods](https://docs.autter.dev/cli/install) (`curl`, PowerShell, Nix)
- [Other install methods](https://autter.dev/docs/cli/install) (`curl`, PowerShell, Nix)
11 changes: 8 additions & 3 deletions specs/autter_standard_v3.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S

The [Autter project](https://github.com/autter-dev/autter-cli) is a full, production-ready implementation of this standard built as a Git extension. Another project would be considered compliant with this standard if it also attached AI Authorship Logs with Git Notes, even if it was implemented in another way.

If you are trying to add support for your Coding Agent to Autter format, that is best done by [integrating with published implementation](https://autter.dev/docs/cli/add-your-agent), not implementing this spec.
If you are trying to add support for your Coding Agent to Autter format, that is best done by [integrating with published implementation](https://autter.dev/docs/guides/add-your-agent), not implementing this spec.

## 1. Authorship Logs

Expand Down Expand Up @@ -265,7 +265,7 @@ Each entry in the `prompts` object represents an AI session in the legacy format
| `total_additions` | integer | REQUIRED | Total lines added by this session |
| `total_deletions` | integer | REQUIRED | Total lines deleted by this session |
| `accepted_lines` | integer | REQUIRED | Lines accepted in the final commit |
| `overriden_lines` | integer | REQUIRED | Lines that were later modified by human (see E-001) |
| `overriden_lines` | integer | REQUIRED | Lines that were later modified by human (see E-001; readers also accept `overridden_lines`) |
| `custom_attributes` | object | OPTIONAL | User-defined key-value string pairs from configuration |

**Deprecated:** The `messages` array field was removed as of v1.3.4 and MUST NOT appear in new notes.
Expand Down Expand Up @@ -908,7 +908,12 @@ The length of IDs (currently 14 hex chars for each component, 16 total with pref

### Errata

E-001: The field name `overriden_lines` was introduced as a typographical error in v3.0.0 and shipped in the reference autter implementation, where it became canonical. In v4.x, this field WILL be renamed to `overridden_lines`.
E-001: The field name `overriden_lines` was introduced as a typographical error in v3.0.0 and shipped in the reference autter implementation, where it became canonical. In v4.x, this field WILL be renamed to `overridden_lines`. Until then, in every object that carries the counter (`prompts` entries, session `stats` and their per-file `files` entries):

- Readers MUST accept both `overriden_lines` and `overridden_lines`. When both are present, readers MUST use `overridden_lines`. When neither is present, the count is 0.
- Readers MUST ignore members they do not recognise, so a note carrying both spellings stays readable.
- Writers of v3.x notes MUST emit `overriden_lines`. They MAY also emit `overridden_lines` with the same value; the reference implementation does not yet (it reads both from autter 3.12.0). Writers MUST NOT emit only `overridden_lines` in a v3.x note, because an older reader that rewrites the note would drop the count.
- Adding the second key does not change the schema version.

E-002: The `messages` array field in prompt records was deprecated in v1.3.4 and removed. It MUST NOT appear in new notes. The optional `messages_url` field remains available in `prompts` for linking to externally-stored transcripts. Session records do not carry `messages_url` as session IDs map directly to agent conversation data.

Loading
Loading