Agent Friendly Code

supermemoryai/supermemory

GitHub
https://github.com/supermemoryai/supermemory

Memory and context engine + app that is extremely fast, scalable, and can be run fully locally. The Memory API for the AI era.

  • agent-memory
  • ai-memory
  • cloudflare-kv
  • cloudflare-pages
  • cloudflare-workers
  • drizzle-orm
  • memory
  • postgres
  • remix
  • tailwindcss
  • typescript
  • vite
Stars:
31.5k
Language:
TypeScript
Default branch:
main
Last scored:
Overall

At a glance

Rank
#153 of 401
Top 38% · #44 of 82 TypeScript repos
Checks passed
8 of 17
Full list below
Best set up for
Claude Code
Score 76.8
Needs most work for
Gemini CLI
Biggest fix: GEMINI.md (+10.9 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    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
  2. 2
    Pre-commit / git hooks
    Set up pre-commit (.pre-commit-config.yaml), husky, or lefthook to run format+lint on every commit.
    +5.3 pts
  3. 3
    Reproducible dev env
    Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
    +4.7 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
#152 of 401
76.8
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ~Reproducible dev env
Cursor
#87 of 401
74.8
  • ✓Cursor rules (.cursor/rules)
  • ✓README
  • ✗Type configuration
Devin
#131 of 401
73.9
  • ~Reproducible dev env
  • ✓Dependency manifest
  • ~Test suite
Codex
#172 of 401
73.2
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ~Test suite
Pi
#154 of 401
73.2
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Linter / formatter config
Kimi Code CLI
#164 of 401
72.9
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Dependency manifest
OpenHands
#178 of 401
66.9
  • ✓CI configuration
  • ✓Dependency manifest
  • ~Reproducible dev env
Aider
#195 of 401
66.5
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ~Test suite
Gemini CLI
#209 of 401
63.6
  • ✗GEMINI.md
  • ✓README
  • ~Test suite

Does supermemoryai/supermemory 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) · 12,769 characters
Agent-specific files
apps/docs/.cursor/rules (new tab) (1 .mdc file)No GEMINI.md, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
62 of 82 TypeScript repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 8 passed

Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (12,769 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
11 GitHub Actions workflows
.github/workflows
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 100% pass
1 .mdc file in .cursor/rules/ folders
apps/docs/.cursor/rules/docs.mdc
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 60% pass
package.json has 7 scripts
package.json
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 100% pass
Config detected
biome.json
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (17,052 characters)
README.md
Manageable size· 80% pass
912 files
Test suite· 70% pass
Test files detected (apps/mcp/e2e/auth.test.ts)
apps/mcp/e2e/auth.test.ts
Type configuration· 0% pass
No type config found

How supermemoryai/supermemory compares

vs leaderboard average
4.5 pts above
Average 66.8
vs TypeScript average
0.1 pts above
Average 71.2
Stars among TypeScript repos
#55 of 82

Missing here, and how many repos have it

  • Type configuration · passed by 68% of leaderboard repos, 68% of TypeScript repos
  • Pre-commit / git hooks · passed by 29% of leaderboard repos, 48% of TypeScript repos
  • Skills (.agents/skills) · passed by 17% of leaderboard repos, 30% of TypeScript repos

Passes checks most repos miss

  • Cursor rules (.cursor/rules) · only 4% of repos pass it

One fix for the most agents: Type configuration would raise the score for all 9 agents, by up to 11.5 points.

Similar repos

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

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

Check the score on every pull request

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