cognee: Skill for Claude Code

.agents/skills/cognee-server/SKILL.md

cognee-server is a skill for Claude Code, Codex from topoteretes/cognee. It costs 50 tokens per session (770 once invoked), scanned A, original, Apache-2.0.

Instructions for running Cognee, an AI memory system, as a local web server with an optional browser interface. It covers the API, health checks, client connections, and local authentication settings.

In plain words
What is it for?
Use it to run the Cognee API or UI locally, check whether the server is healthy, connect an SDK or CLI, and choose single-user or multi-user access.
Why use it?
It explains how to start Cognee and avoid connection or authentication mistakes when using it on your own machine.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is topoteretes/cognee's own configuration. It tells Claude Code and Codex how to work on cognee itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything cognee configures →

About the project

Cognee is an AI memory platform that stores information in a self-hosted knowledge graph so agents can retain context across sessions. It ingests data, connects related information, and helps agents retrieve it for reasoning and actions. The catalogue includes skills and instructions that extend agent workflows around Cognee.

topoteretes/cognee · 33,094 stars · on GitHub · cognee.ai

Reuse

Borrowing it

Nothing to install: this file belongs to topoteretes/cognee. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/topoteretes/cognee/main/.agents/skills/cognee-server/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/topoteretes/cognee

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cognee-server

README.md
[![agentmods](https://agentmods.dev/badge/skills/topoteretes/cognee/cognee-server/github.svg)](https://agentmods.dev/skills/topoteretes/cognee/cognee-server)
Your own site
<a href="https://agentmods.dev/skills/topoteretes/cognee/cognee-server"><img src="https://agentmods.dev/badge/skills/topoteretes/cognee/cognee-server/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cognee-server

Your own site · 80×15
<a href="https://agentmods.dev/skills/topoteretes/cognee/cognee-server"><img src="https://agentmods.dev/badge/skills/topoteretes/cognee/cognee-server.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 50 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 770 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Snyk pass 7 Sept 2026
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Tool Misuse · line 31
    Tool defaults are unsafe or overly permissive (e.g. disabled TLS verification, no authentication, world-writable permissions). Unsafe defaults widen the attack surface.
    Fix: Override unsafe defaults with secure settings (verify=True, auth required, restrictive permissions). Review and harden all tool configurations.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00050 $0.00770
Opus 5.5 $0.00020 $0.00308
Sonnet 5.5 $0.00010 $0.00154
Haiku 4.5 $0.00005 $0.00077

Measured 7d ago against content hash 10ebb1a4c735, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cognee-server scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/cognee-server/SKILL.md · 77 lines

How it starts

The opening of the file, as written. The whole thing — 77 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Start the cognee server locally

From an installed cognee (no Docker)

cognee-cli -ui

launches the full local stack: FastAPI backend on http://localhost:8000 and the UI on http://localhost:3000. Needs LLM_API_KEY in the environment or .env. The interactive API reference is at http://localhost:8000/docs, health at /health.

For API-only serving via Docker instead, use the cognee-docker skill (the prebuilt cognee/cognee:main image or docker compose up from the repo).

Auth posture

ENABLE_BACKEND_ACCESS_CONTROL decides everything:

  • true (default): multi-tenant — auth required on every API call, per user+dataset database isolation.
  • false: single-user local mode — no auth, shared local databases. Right choice for a personal dev server; never for anything exposed.

REQUIRE_AUTHENTICATION=false is ignored while access control is on; to turn auth off you must set ENABLE_BACKEND_ACCESS_CONTROL=false.

Behind a TLS-terminating proxy set AUTH_TOKEN_COOKIE_SECURE=true so the auth cookie gets the Secure attribute; leave it off for plain http://localhost, where a browser refuses to store a Secure cookie.

Connecting clients to the running server

  • SDK / CLI against the server (instead of embedded local mode):

    cognee-cli serve --url http://localhost:8000        # local instance
    cognee-cli serve --url https://... --api-key ck_... # cognee cloud instance
    cognee-cli serve                                    # reconnect to the saved keyed instance
    cognee-cli serve --logout                           # disconnect
    

    In Python: await cognee.serve(url="http://localhost:8000").

  • HTTP: main routes live under /api/v1/ — the memory API is remember (plus remember/entry), recall, improve, forget; sessions covers session memory; datasets, users, visualize handle the rest. The legacy add, cognify, search, and delete routes still exist and are what the memory routes call underneath (see cognee/api/client.py for the registered routers, or GET /openapi.json on a running server).

Read the full file on GitHub · 77 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago Changed · +5 lines 10ebb1a4c735
  2. 21d ago Changed 4ee4e513a979
  3. 2mo ago First seen · 72 lines · 50 tokens per session scan A cfe8c98f834e

Subscribe to this mod's changes

cognee-server is a skill published in the GitHub repository topoteretes/cognee (33,094 stars, last pushed today), licensed Apache-2.0. It adds 50 tokens to every session and 770 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

cognee-server compared with skills from other repositories

cognee-server next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
cognee-servertopoteretes/cogneeSkill33ktodayApache-2.0A50Claude Code, Codex
openmemoryCaviraOSS/OpenMemorySkill4.6k19d agoApache-2.0A96Claude Code, Codex
verifyplastic-labs/honchoSkill8.0kyesterdayAGPL-3.0A55Claude Code, Codex
memseek-remembermemseekai/memseekSkill11yesterdayApache-2.0A24Claude Code
memseek-explainmemseekai/memseekSkill11yesterdayApache-2.0A25Claude Code
memseek-searchmemseekai/memseekSkill11yesterdayApache-2.0A22Claude Code
surface-learningsterrizoaguimor/celiums-memorySkill232mo agoApache-2.0A60Claude Code