Quickstart

From install to insight in 3 steps

1

Install via pip

pip install bespokeagile-coauthor

Or clone from GitHub: git clone https://github.com/bespokeagile/coauthor

2

Add MCP server to Claude Code

{
  "mcpServers": {
    "coauthor": {
      "command": "coauthor",
      "args": ["mcp"]
    }
  }
}

Add this to your Claude Code MCP config (or ~/.claude/mcp_servers.json). Coauthor exposes 10 tools for authorship analysis.

3

Ask in natural language

"Who owns the authentication module?"
"What's the bus factor for src/api/"
"Show me the highest-impact commits this month"

Your AI assistant calls Coauthor's MCP tools to analyze git history and return structured insights.

CLI Reference

6 commands

coauthor scan Analyze git history for the current repo
coauthor who-owns <path> Show ownership for a file or directory
coauthor impact <commit> Score a commit's structural impact
coauthor patterns Classify all contributors by pattern
coauthor serve Start the web dashboard (localhost:8002)
coauthor mcp Start the MCP server (stdio transport)

Distribution

Available everywhere

Licensed under Apache-2.0. Free to use, modify, and distribute.