Agent Friendly Code

PostHog/posthog

GitHub
https://github.com/PostHog/posthog

PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all…

Stars:
40.6k
Language:
Python
Default branch:
master
Last scored:
Overall

At a glance

Rank
#8 of 401
Top 2% · #3 of 56 Python repos
Checks passed
12 of 17
Full list below
Best set up for
Cursor
Score 93.9
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    Manageable size
    If possible, split into smaller modules or carve out a focused entry path. Document where to start in AGENTS.md.
    +5.3 pts
  2. 2
    Test suite
    Add a tests/ (or test/, __tests__/, spec/) directory with runnable tests. Document how to run them in AGENTS.md.
    +3.9 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 →

Cursor
#2 of 401
93.9
  • ✓Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration
Kimi Code CLI
#9 of 401
92.1
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Dependency manifest
Codex
#11 of 401
91.9
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ~Test suite
Devin
#2 of 401
91.1
  • ✓Reproducible dev env
  • ✓Dependency manifest
  • ~Test suite
Pi
#15 of 401
91.1
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Linter / formatter config
Claude Code
#28 of 401
90.8
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Reproducible dev env
Gemini CLI
#16 of 401
81.8
  • ✗GEMINI.md
  • ✓README
  • ~Test suite
OpenHands
#12 of 401
81.7
  • ✓CI configuration
  • ✓Dependency manifest
  • ✓Reproducible dev env
Aider
#48 of 401
77.2
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ~Test suite

Does PostHog/posthog 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
AGENTS.md (new tab) · 47,012 characters
Agent-specific files
.cursor/rules (new tab) (3 .mdc files), .agents/skills (new tab) (117 skills)No GEMINI.md, .openhands/setup.sh or .aider.conf.yml
Repos that have one
29 of 56 Python repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 12 passed

Skills (.agents/skills)· 100% pass
117 skills in .agents/skills/
.agents/skills/adding-activity-logging/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (47,012 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
142 GitHub Actions workflows
.github/workflows
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 100% pass
3 .mdc files in .cursor/rules/
.cursor/rules/django-python.mdc
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 100% pass
2 env artifacts (Dockerfile, .cursor/environment.json)
Dockerfile
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 100% pass
Configured in pyproject.toml
pyproject.toml
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
.husky
README· 100% pass
README detailed (13,727 characters)
README.md
Manageable size· 20% pass
10000+ files — very large
Test suite· 70% pass
Test files detected (.github/scripts/assign-reviewers.test.js)
.github/scripts/assign-reviewers.test.js
Type configuration· 100% pass
Type config present
tsconfig.json

How PostHog/posthog compares

vs leaderboard average
21.2 pts above
Average 66.8
vs Python average
17.0 pts above
Average 71.0
Stars among Python repos
#35 of 56

Passes checks most repos miss

  • Skills (.agents/skills) · only 17% of repos pass it
  • Cursor rules (.cursor/rules) · only 4% of repos pass it
  • 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: Manageable size would raise the score for all 9 agents, by up to 5.7 points.

Similar repos

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

All Python 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/PostHog/posthog
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/PostHog/posthog.svg)](https://agentfriendlycode.com/repo/github/PostHog/posthog)

Check the score on every pull request

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