← All skills

self-hosted-companion

95 / 100 · Low risk

Fine to try.

By topoteretes/cognee (GitHub) · data · 33,239 stars · scanned at commit 8853378

Chat with a companion that knows your notes folder (a journal, an Obsidian vault, any .md or .txt files) and every earlier chat, using cognee memory with local databases. Use when someone wants to ask questions about their own notes, or to talk with a companion that remembers past conversations. Runs locally; reads the notes folder, writes only to cognee's memory.

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'self-hosted-companion' ] || [ -L ~/.agents/skills/'self-hosted-companion' ]; then echo 'A skill folder named self-hosted-companion already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/topoteretes/cognee' "$d" && git -C "$d" checkout --quiet '8853378eae5366addb064e758e560a456146ae1a' -- '.agents/skills/self-hosted-companion' && mkdir -p ~/.agents/skills && cp -R "$d"/'.agents/skills/self-hosted-companion' ~/.agents/skills/'self-hosted-companion' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'self-hosted-companion' ~/.claude/skills/'self-hosted-companion' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for topoteretes/cognee shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/topoteretes/cognee.svg)](https://zalavijaysinh.github.io/skilltrust/repos/topoteretes/cognee/)

Score history