timescale/timescaledb

At a glance

Rank

#321 of 401

#4 of 10 C repos

Checks passed

7 of 17

Full list below

Best set up for

Aider

Score 60.6

Needs most work for

Cursor

Biggest fix: Cursor rules (.cursor/rules) (+11.5 pts)

What to fix first

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
   Reproducible dev env

   Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
   +11.8 pts
3. 3
   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

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 →

Does timescale/timescaledb 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

2 of 10 C repos · 221 of 401 repos on the leaderboard · See examples →

# AGENTS.md

Guidance for AI coding agents working in timescale/timescaledb. A time-series database for high-performance real-time analytics packaged as a Postgres extension. Written mainly in C.

## Where things are

- Dependencies are declared in `CMakeLists.txt`.
- Tests live in `test`.
- Lint and format rules are configured in `.clang-format`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- Follow the conventions in `CONTRIBUTING.md`.

## Commands

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

How timescale/timescaledb compares

vs leaderboard average

10.4 pts below

Average 66.8

vs C average

0.5 pts above

Average 55.9

Stars among C repos

#6 of 10

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.

• git/git59.6
  C · 64.2k ★
• obsproject/obs-studio54.6
  C · 78.9k ★
• curl/curl54.1
  C · 43.4k ★
• openssl/openssl50.1
  C · 31.2k ★
• redis/redis46.4
  C · 77.2k ★
• postgres/postgres46.0
  C · 22.7k ★

Same topics, any language

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

• questdb/questdb61.9
  Java · database, historian, SQL, time series, time series database, tsdb
• getnao/nao84.4
  TypeScript · analytics, PostgreSQL, SQL
• metabase/metabase85.9
  Clojure · analytics, database, PostgreSQL
• duckdb/duckdb70.2
  C++ · analytics, database, SQL
• ClickHouse/ClickHouse67.6
  C++ · analytics, database, SQL
• StarRocks/starrocks60.7
  Java · analytics, database, SQL