Phren learns and recalls.

Findings, fragments, tasks, truths, skills, and sessions across machines. Private markdown. Git-backed. No database.

$ npx @phren/cli init

One command. Creates ~/.phren, wires MCP, installs hooks.

Add a project

phren add from any repo.

Already have one?

phren init picks it up.

Source Whitepaper

How phren works

Prepares your context. Stays out of your way.

Phren listens and learns

Phren catches findings, links fragments across projects, and figures out what matters. Gets sharper over time.

Follows you everywhere

Git syncs after every response, pulls on open. Your knowledge travels with you, not your machine.

Browse it all

Interactive shell, web UI, and VS Code sidebar. Browse findings, fragments, and the full knowledge graph. Search across projects.

Under the hood

Three hooks.

SessionStart on open

git pull sync from remote

detectProject(cwd) match to phren project

inject(context) instructions enter context window

UserPromptSubmit every message

extractKeywords bigrams, stopword filter

fts5.search synonyms, sub-ms lookup

trustFilter decay, citation, threshold

inject(top3) budget-capped context

Stop after response

git commit save changes

background push rebase on conflict

Why phren

Your agents forget.
Phren doesn't.

Packs light.

CLAUDE.md dumps everything every time. Phren searches, ranks, and surfaces only what matches. About 550 tokens instead of the whole file. Less noise, lower cost.

CLAUDE.md

bloated

Phren

550 default

Same brain, every tool.

Switch agents, switch machines. Phren keeps up. What you figured out in Claude this morning is already there when you open Cursor tonight. Good stuff sticks. Bad stuff fades.

Claude Code Copilot Cursor Codex

Claude ♥ phren

Built for each other.

Claude asks a question. Phren already looked it up. The findings, the gotchas, the thing that broke last time. All there before the first token.

Phren's shell

Access phren directly.

Browse what phren knows. Check on tasks. Review the queue. Type : for the command palette.

phren shell

Phren's brain map

See everything phren holds.

Run phren web-ui to open a visual map of everything phren holds. Findings, connections, quality scores, and what needs your attention.

localhost:3499 · phren web-ui

Projects

web-project-1 97

api-service 41

mobile-app 23

art-project-1 19

global

Views

Graph

Queue

Task

pattern

Turbo family builds avoid false dist races

projectweb-project-1

machinedev-laptop

created2026-03-07

confidence

84%

linked fragment

◈build

linked task

▤b4 · Eliminate Angular dev-server linker gap

VS Code extension

Browse phren without leaving your editor.

Projects, findings, tasks, fragments, skills, hooks, sessions, and the interactive knowledge graph. Search, add, review, and push. All from the sidebar.

☰

Activity bar tree

Projects, findings, tasks, skills, hooks, sessions. All browsable.

◆

Fragment graph

Interactive webview. Click nodes, explore connections, edit findings in-graph.

Ctrl+Shift+K

Search phren's knowledge base without leaving your editor.

Team Knowledge

Share Knowledge With Your Team

A team store is a git repo full of phren knowledge. Share it with your teammates and everyone's findings flow through the same place. Keep as many as you like, one per team, company, or client.

Make a git repo

Any empty git repo will do. Run phren store add and point it at the remote. Phren fills in the structure.

Share the repo with teammates

They run the same phren store add against the repo URL. That's it. Phren pulls on open and pushes after each response.

Add as many as you want

No cap on stores. One for your team, one for the company, one for a client. Search runs across every store at once.

Phren's tricks

54 MCP tools built in.
Skills for the bigger stuff.

MCP tools handle search, capture, review, and sync. Skills are shortcuts for larger jobs. Global skills live in ~/.phren/global/skills/, project skills in ~/.phren/<project>/skills/. Project skills override global ones with the same name.

/phren-init

Point phren at a new project. Sets up files and starts learning.

/phren-consolidate

Tidies up. Finds patterns, deduplicates, promotes what matters.

/phren-discover

Scans a project for gaps and surfaces opportunities you missed.

/phren-sync

Pull phren to a new machine or push config changes back to the repo.

+ your own

Global: ~/.phren/global/skills/
Per-project: ~/.phren/<project>/skills/

Works everywhere

One brain. Every agent.

[PATTERN]

fts5.search: sub-ms lookup, same hits in every agent

phren · just now · trust 0.92

MCP and hooks. Same knowledge, same findings, no matter which tool you're in.

Claude Code Copilot Cursor Codex VS Code CLI