codemium

README

Codemium

Generate code statistics across all repositories in a Bitbucket Cloud workspace or GitHub organization. Produces per-repo and aggregate metrics including lines of code, comments, blanks, and cyclomatic complexity for 200+ languages.

Features

• Analyze all repos in a Bitbucket workspace or GitHub organization
• Filter by Bitbucket projects, specific repos, or exclusion lists
• Per-language breakdown: files, code lines, comments, blanks, complexity
• JSON output (default) and optional markdown summary
• Parallel processing with configurable concurrency
• Progress bar in terminal, plain text fallback in CI/CD
• Pure Go, no external dependencies at runtime (no git or scc binary needed)

Installation

Pre-built binaries

Download from the releases page.

From source

go install github.com/dsablic/codemium/cmd/codemium@latest

Authentication

Codemium supports interactive API token login and environment variable tokens.

Bitbucket

Option 1: API token (interactive)

1. Create a scoped API token at https://id.atlassian.com/manage-profile/security/api-tokens — click "Create API token with scopes", select Bitbucket as the app, and enable Repository Read
2. Run:

   codemium auth login --provider bitbucket
   

   This prompts for your Atlassian email and API token. Credentials are verified against the Bitbucket API and stored at ~/.config/codemium/credentials.json.

Option 2: Environment variable (CI/CD)

export CODEMIUM_BITBUCKET_USERNAME=your_email
export CODEMIUM_BITBUCKET_TOKEN=your_api_token

GitHub

Option 1: OAuth device flow (interactive)

1. Create a GitHub OAuth App (or use an existing one)
2. Set:

   export CODEMIUM_GITHUB_CLIENT_ID=your_client_id
   

3. Run:

   codemium auth login --provider github
   

   This displays a code to enter at github.com/login/device.

Option 2: Environment variable (CI/CD)

export CODEMIUM_GITHUB_TOKEN=your_personal_access_token

Usage

Analyze a Bitbucket workspace

# All repos in a workspace
codemium analyze --provider bitbucket --workspace myworkspace

# Filter by Bitbucket projects
codemium analyze --provider bitbucket --workspace myworkspace --projects PROJ1,PROJ2

# Specific repos only
codemium analyze --provider bitbucket --workspace myworkspace --repos repo1,repo2

# Exclude repos
codemium analyze --provider bitbucket --workspace myworkspace --exclude old-repo,deprecated-repo

Analyze a GitHub organization

# All repos in an org
codemium analyze --provider github --org myorg

# Specific repos
codemium analyze --provider github --org myorg --repos api,frontend

Output options

# JSON to stdout (default)
codemium analyze --provider github --org myorg

# JSON to file
codemium analyze --provider github --org myorg --output report.json

# Markdown summary
codemium analyze --provider github --org myorg --markdown report.md

# Both
codemium analyze --provider github --org myorg --output report.json --markdown report.md

Additional flags

--concurrency 10       # Parallel workers (default: 5)
--include-archived     # Include archived repos (excluded by default)
--include-forks        # Include forked repos (excluded by default)

Output Format

JSON

{
  "generated_at": "2026-02-18T12:00:00Z",
  "provider": "github",
  "organization": "myorg",
  "filters": {},
  "repositories": [
    {
      "repository": "my-repo",
      "provider": "github",
      "url": "https://github.com/myorg/my-repo",
      "languages": [
        {
          "name": "Go",
          "files": 42,
          "lines": 5000,
          "code": 3800,
          "comments": 400,
          "blanks": 800,
          "complexity": 120
        }
      ],
      "totals": {
        "files": 42,
        "lines": 5000,
        "code": 3800,
        "comments": 400,
        "blanks": 800,
        "complexity": 120
      }
    }
  ],
  "totals": {
    "repos": 1,
    "files": 42,
    "lines": 5000,
    "code": 3800,
    "comments": 400,
    "blanks": 800,
    "complexity": 120
  },
  "by_language": [
    {
      "name": "Go",
      "files": 42,
      "lines": 5000,
      "code": 3800,
      "comments": 400,
      "blanks": 800,
      "complexity": 120
    }
  ]
}

Markdown

The --markdown flag generates a GitHub-flavored markdown report with:

• Summary table with aggregate metrics
• Language breakdown sorted by code lines
• Per-repository table with links
• Error section for repos that failed to process

License

MIT License - see LICENSE for details.