Phren

Your agents forget everything. Phren doesn't.

Persistent memory for AI agents. Findings, tasks, and patterns live in markdown files in a git repo you control. No database, no vendor lock-in. Works with Claude, Copilot, Cursor, and Codex.

---

Install

npx @phren/cli init

One command. Sets up `~/.phren`, wires up MCP for your tools, installs hooks. Next time you open a project, context starts flowing automatically. On a new machine? Re-run init and you're back in sync.

---

What actually happens

**When you open a prompt:**

• Hooks extract keywords from your question
• Phren searches findings across projects (FTS5 full-text with semantic fallback)
• Relevant snippets inject into your prompt before you hit send
• You ask; Claude already knows the gotchas

**When you discover something:**

• phren add-finding "finding text" captures it with optional tags ([decision], [pattern], [pitfall], [bug])
• Trust scores decay over time; decisions never do; observations expire in 14 days
• Findings link to fragments (named concepts like "auth" or "build") that connect knowledge across projects

**