plausible/analytics

GitHub
https://github.com/plausible/analytics

Open source, privacy-first web analytics. Lightweight, cookie-free Google Analytics alternative. Self-hosted or cloud.

  • analytics
  • analytics-dashboard
  • clickhouse
  • elixir
  • google-analytics
  • marketing
  • open-source-analytics
  • phoenix
  • plausible-analytics
  • postgresql
  • privacy
  • privacy-friendly
  • self-hosted
  • simple-analytics
  • statistics
  • tailwindcss
  • web-analytics
  • website-analytics
  • website-stats
  • website-tracking
Stars:
29.8k
Language:
Elixir
Default branch:
master
Last scored:
Overall

At a glance

Rank
#171 of 401
Top 43% · #1 of 7 Elixir repos
Checks passed
9 of 17
Full list below
Best set up for
Claude Code
Score 75.7
Needs most work for
Cursor
Biggest fix: Cursor rules (.cursor/rules) (+11.5 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    AGENTS.md / CLAUDE.md
    Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
    +13.2 pts
  2. 2
    Type configuration
    Add a type config (tsconfig.json for JS/TS, mypy.ini or pyrightconfig.json for Python). Rust/Go/JVM/Scala/Swift/C#/OCaml/Haskell/Zig are typed by default.
    +7.9 pts
  3. 3
    Manageable size
    If possible, split into smaller modules or carve out a focused entry path. Document where to start in AGENTS.md.
    +3.3 pts

Score for each AI agent

Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Claude Code
#166 of 401
75.7
  • ✗AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Reproducible dev env
Devin
#120 of 401
75.0
  • ✓Reproducible dev env
  • ✓Dependency manifest
  • ✓Test suite
OpenHands
#105 of 401
72.5
  • ✓CI configuration
  • ✓Dependency manifest
  • ✓Reproducible dev env
Aider
#116 of 401
71.8
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ✓Test suite
Codex
#196 of 401
71.5
  • ✗AGENTS.md / CLAUDE.md
  • ✓README
  • ✓Test suite
Kimi Code CLI
#183 of 401
70.7
  • ✗AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Dependency manifest
Pi
#189 of 401
70.0
  • ✗AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Linter / formatter config
Gemini CLI
#196 of 401
64.7
  • ✗GEMINI.md
  • ✓README
  • ✓Test suite
Cursor
#236 of 401
60.9
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✗Type configuration

Does plausible/analytics have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md
None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
1 of 7 Elixir repos · 221 of 401 repos on the leaderboard · See examples →
Get a starter AGENTS.md

From the files the checks found. Fill in the commands, then commit it at the root.

# AGENTS.md

Guidance for AI coding agents working in plausible/analytics. Open source, privacy-first web analytics. Written mainly in Elixir.

## Where things are

- Dependencies are declared in `mix.exs`.
- Tests live in `test`.
- Lint and format rules are configured in `.credo.exs`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- Commit hooks are set up in `.pre-commit-config.yaml`; don't skip them.
- Common tasks are targets in `Makefile`.
- Follow the conventions in `CONTRIBUTING.md`.

## Commands

<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO

All 17 checks · 9 passed

No .agents/skills/<name>/SKILL.md
No agent instructions file found
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
15 GitHub Actions workflows
CONTRIBUTING guide· 100% pass
Guide present
No .cursor/rules/*.mdc or .cursorrules
Manifest present
2 env artifacts (Makefile, Dockerfile)
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
Config detected
No .openhands/setup.sh
Hook framework configured
README· 100% pass
README detailed (12,662 characters)
Manageable size· 50% pass
2093 files — large
Test suite· 100% pass
Found /test
No type config found

How plausible/analytics compares

vs leaderboard average
3.5 pts above
Average 66.8
vs Elixir average
8.8 pts above
Average 61.5
Stars among Elixir repos
#1 of 7

Missing here, and how many repos have it

  • Type configuration · passed by 68% of leaderboard repos, 0% of Elixir repos
  • Skills (.agents/skills) · passed by 17% of leaderboard repos, 0% of Elixir repos
  • Cursor rules (.cursor/rules) · passed by 4% of leaderboard repos, 0% of Elixir repos

Passes checks most repos miss

  • Reproducible dev env · only 22% of repos pass it
  • Pre-commit / git hooks · only 29% of repos pass it

One fix for the most agents: AGENTS.md / CLAUDE.md would raise the score for all 9 agents, by up to 13.3 points.

Similar repos

Same language and host as this repo, closest in overall score.

All Elixir repos →

Same topics, any language

Repos tagged with the same GitHub topics, most shared first.

Add a badge to your README

Paste this at the top of the README. It shows the score, and links back to this page.

Agent friendly score for github/plausible/analytics
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/plausible/analytics.svg)](https://agentfriendlycode.com/repo/github/plausible/analytics)

Check the score on every pull request

A GitHub Action posts one comment per pull request with how the score changed and why.