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

Team knowledge, shared.

Team stores are shared git repos with phren-structured data. Your team's findings sync automatically. Personal knowledge stays private. One command to join.

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.

Phren's tricks

53 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/

Phren learns and recalls.

Prepares your context. Stays out of your way.

Three hooks.

Your agents forget.
Phren doesn't.

Built for each other.

Access phren directly.

See everything phren holds.

Browse phren without leaving your editor.

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

One brain. Every agent.

Your knowledge, your repo.

Phren learns and recalls.

Prepares your context. Stays out of your way.

Three hooks.

Your agents forget.Phren doesn't.

Built for each other.

Access phren directly.

See everything phren holds.

Browse phren without leaving your editor.

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

One brain. Every agent.

Your knowledge, your repo.

Your agents forget.
Phren doesn't.

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