AGENTS.mdA

AGENTS.md from topoteretes/cognee is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add topoteretes/cognee/AGENTS.md@git:20261020.1c3c68c

Pins git:20261020.1c3c68c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
topoteretes/cognee
Path
AGENTS.md
Versions recorded
18
Latest version
git:20261020.1c3c68c, committed Oct 20, 2026
First version recorded
Jan 8, 2026
Size
11,700 bytes
Repository stars
33,092
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## Repository Guidelines

This document summarizes how to work with the cognee repository: how it’s organized, how to build, test, lint, and contribute. It mirrors our actual tooling and CI while providing quick commands for local development.

## Design Principles

1. **Don't overengineer**: Simple beats complex.
2. **No fallbacks**: One correct path, no alternatives.
3. **One way**: One way to do things, not many.
4. **Throw errors**: Fail fast when the operation's preconditions aren't met. Observability (telemetry, logging) is best-effort and never changes the outcome of the operation.
5. **No backups**: Trust the primary mechanism.
6. **Separation of concerns**: Each function has a single responsibility.
7. **Be concise but informative**: No essays, but the docstrings and comments a reader needs.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add topoteretes/cognee/AGENTS.md@sha256:10637b64b1c64016

The line at the top of this page pins the label git:20261020.1c3c68c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_h63jtcek2lg5j7ap.svg)](https://markdownregistry.com/a/art_h63jtcek2lg5j7ap)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 18 versions of this file, between Jan 8, 2026 and Oct 20, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
git:20261020.1c3c68c latest2026-10-20 1c3c68c 11,700 BA view · diff
git:20261020.98d221f2026-10-20 98d221f 11,578 BA view · diff
git:20261020.3f6eaed2026-10-20 3f6eaed 11,570 BA view · diff
git:20261020.9deea612026-10-20 9deea61 11,507 BA view · diff
git:20261015.8971ebe2026-10-15 8971ebe 10,453 BA view · diff
git:20261005.30e876a2026-10-05 30e876a 10,463 BA view · diff
git:20260929.233b5142026-09-29 233b514 10,245 BA view · diff
git:20260929.d802d122026-09-29 d802d12 9,312 BA view · diff
git:20260929.d4637592026-09-29 d463759 9,611 BA view · diff
git:20260929.78a83ab2026-09-29 78a83ab 9,532 BA view · diff
git:20260929.8945fa12026-09-29 8945fa1 9,387 BA view · diff
git:20260915.c8f8cf12026-09-15 c8f8cf1 8,785 BA view · diff
git:20260907.268f14c2026-09-07 268f14c 8,029 BA view · diff
git:20260808.7cd72c92026-08-08 7cd72c9 7,858 BA view · diff
git:20260808.ee744a62026-08-08 ee744a6 5,790 BA view · diff
git:20260518.a3776692026-05-18 a377669 5,771 BA view · diff
git:20260421.1d674142026-04-21 1d67414 5,504 BA view · diff
git:20260108.7a48e222026-01-08 7a48e22 5,508 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (11700 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

topoteretes/cognee · 33,092 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_h63jtcek2lg5j7ap
GET https://markdownregistry.com/api/v1/resolve?ref=topoteretes/cognee/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/10637b64b1c64016993a1e5d9108fb7f8c1dcd4bd1ddbcc3ff6e609653340ee6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from topoteretes/cognee

cognee-cli SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-cli/SKILL.md · Use when the user wants to drive cognee from the terminal with cognee-cli — remember/recall/forget/improve memory…
git:20261027.d35833c · audit A · 33,092 stars
cognee-community SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-community/SKILL.md · Use when the user needs something that ships outside cognee core — community database adapters (Qdrant, Milvus…
git:20260929.d802d12 · audit A · 33,092 stars
cognee-custom-graph-models SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-custom-graph-models/SKILL.md · Use when defining the shape of cognee's knowledge graph with graph_model= — writing DataPoint node classes, choosing…
git:20261009.200aa80 · audit A · 33,092 stars
cognee-custom-pipelines SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-custom-pipelines/SKILL.md · Use when building your own cognee processing — writing custom tasks, chaining them into a pipeline with…
git:20261015.e77d382 · audit A · 33,092 stars
cognee-docker SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-docker/SKILL.md · Use when the user wants to run cognee with Docker or docker compose — trying it out from the prebuilt image, starting…
git:20260929.d802d12 · audit A · 33,092 stars
cognee-forget SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-forget/SKILL.md · Use when removing data from cognee memory with forget() in the SDK, HTTP API, or CLI — finding which dataset and…
git:20261027.17a737c · audit A · 33,092 stars
cognee-improve-sessions SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-improve-sessions/SKILL.md · Use when working with cognee's session memory or improve() — storing conversation turns, agent traces and feedback with…
git:20261029.a4f73b2 · audit A · 33,092 stars
cognee-ingestion SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-ingestion/SKILL.md · Use when putting data into cognee memory with remember() — choosing inputs (text, files, folders, URLs, repos…
git:20261015.1509b06 · audit A · 33,092 stars
cognee-install SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-install/SKILL.md · Use when the user wants to install cognee and run their first remember → recall flow with the Python SDK — fresh setup…
git:20261015.8971ebe · audit A · 33,092 stars
cognee-integrations SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-integrations/SKILL.md · Use when the user wants to connect cognee to external services — switching LLM or embedding providers (OpenAI, Azure…
git:20261027.17a737c · audit A · 33,092 stars
cognee-migrations SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-migrations/SKILL.md · Use when dealing with cognee database migrations — understanding when they run automatically, checking or repairing…
git:20261018.6286687 · audit A · 33,092 stars
cognee-performance SKILL.md skill
topoteretes/cognee · .agents/skills/cognee-performance/SKILL.md · Use when cognee is slow, expensive, or hitting rate limits — speeding up or throttling ingestion (remember/cognify…
git:20261014.421002d · audit A · 33,092 stars

Every file in topoteretes/cognee

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.