Contributor

Overview

The Contributor struct represents an individual contributor to a commit, whether human or AI agent. Each anchor maintains a list of contributors to provide clear attribution for collaborative work.

Contributor Fields

name

string

required

Name of the contributor.

For humans: Git author name and email (e.g., "Alice <[email protected]>")
For AI agents: Tool name (e.g., "cursor", "claude", "windsurf")

role

ContributorRole

required

Whether this contributor is a human or AI agent.See ContributorRole enum for possible values.

model

string

The AI model used (only present for AI agents).Examples: "claude-sonnet-4-20250514", "gpt-4o", "claude-opus-4"

ContributorRole Enum

Value	Description
`human`	A human developer
`agent`	An AI agent/tool

Example JSON

{
  "name": "Alice <[email protected]>",
  "role": "human"
}

The model field is omitted from JSON when null or when the tool doesn’t report model information.

Usage Examples

Show Human-only commit

When you commit without any AI involvement, there’s a single human contributor:

{
  "author_type": "human",
  "contributors": [
    {
      "name": "Alice <[email protected]>",
      "role": "human"
    }
  ]
}

Show AI-assisted commit

When collaborating with Cursor AI, both you and the AI are listed:

{
  "author_type": "assisted",
  "contributors": [
    {
      "name": "Alice <[email protected]>",
      "role": "human"
    },
    {
      "name": "cursor",
      "role": "agent",
      "model": "claude-sonnet-4-20250514"
    }
  ]
}

Show Autonomous agent commit

When an AI agent commits on its own (non-interactive terminal):

{
  "author_type": "agent",
  "author": "Alice <[email protected]>",
  "contributors": [
    {
      "name": "cursor",
      "role": "agent",
      "model": "claude-sonnet-4-20250514"
    }
  ]
}

Note: The git author is still the human repo owner, but only the AI is listed as a contributor since the human wasn’t actively involved.

Show Multiple AI agents

When multiple AI tools contribute to the same commit:

{
  "author_type": "assisted",
  "contributors": [
    {
      "name": "Bob <[email protected]>",
      "role": "human"
    },
    {
      "name": "cursor",
      "role": "agent",
      "model": "claude-sonnet-4-20250514"
    },
    {
      "name": "aider",
      "role": "agent",
      "model": "gpt-4o"
    }
  ]
}

Contributor vs Author

Key distinction: The author field in an Anchor is always the git author (the human who owns the repo). The contributors list provides the full picture of who actually contributed to the changes.

Human-only commit: contributors has 1 human
Assisted commit: contributors has 1+ humans and 1+ agents
Agent commit: contributors has only agents (but author is still the human)

Anchor - The parent commit structure that contains contributors
SessionLink - Session metadata that identifies agents and models
FileChange - Per-file attribution that uses contributor data

Data Structures

Contributor

Overview

Contributor Fields

ContributorRole Enum

Example JSON

Usage Examples

Contributor vs Author

Build docs developers (and LLMs) love

Data Structures

​Overview

​Contributor Fields

​ContributorRole Enum

​Example JSON

​Usage Examples

​Contributor vs Author

​Related Types

Build docs developers (and LLMs) love

Overview

Contributor Fields

ContributorRole Enum

Example JSON

Usage Examples

Contributor vs Author

Related Types