@doufunao123/cognee-admin

Lightweight npm thin client for the Cognee API. It mirrors the Rust cognee-admin client commands, but ships as a Node.js CLI for npx usage.

Install

npm install -g @doufunao123/cognee-admin

Or run directly:

npx @doufunao123/cognee-admin describe

Auth Sharing

The npm CLI reads and writes the same auth file as the Rust CLI:

{
  "cognee_jwt": "eyJ...",
  "admin_token": "ca_...",
  "cognee_url": "https://cogneeapi.xiaomao.chat"
}

Location: ~/.config/cognee-admin/auth.json

Resolution order:

1. --cognee-url / --cognee-jwt
2. COGNEE_URL / COGNEE_JWT
3. ~/.config/cognee-admin/auth.json
4. Built-in default URL: https://cogneeapi.xiaomao.chat

Usage

cognee-admin login --username alice --password secret
cognee-admin health --detailed
cognee-admin dataset list
cognee-admin data add --dataset docs "hello world"
cognee-admin data add-file --dataset docs ./notes.md
cognee-admin data add-dir --dataset docs --glob "*.md" ./content
cognee-admin cognify --dataset-name docs --background
cognee-admin search "agent memory" --datasets docs,notes --top-k 10
cognee-admin search history
cognee-admin config get
cognee-admin config set '{"llm":{"provider":"openai","model":"gpt-5.4","api_key":"sk-..."}}'
cognee-admin ontology list
cognee-admin ontology upload --key game ./ontology.owl
cognee-admin describe

Output

JSON is the default output format:

{
  "ok": true,
  "command": "dataset.list",
  "data": {
    "items": []
  }
}

Use --human for readable output.

Commands

• health [--detailed] [--watch] [--interval N]
• login --username X --password Y
• dataset list|create|delete|delete-all|status|graph
• data add|add-file|add-dir|list|delete|raw|update
• cognify [--dataset-id X] [--dataset-name X] [--custom-prompt Y] [--custom-prompt-file path] [--background] [--chunks-per-batch N]
• search <query> [--search-type X] [--top-k N] [--datasets a,b] [--verbose]
• search history
• config get|set
• ontology upload|list
• describe [command]