Free · runs on your machine · no content leaves it
See your brain the way your agents do
A free audit of your company brain: any folder of Markdown or text notes. Your own AI agent runs it locally and you get a map of the whole brain, a structural and merit score, and the five fixes that matter most.
Works with Claude Code, Codex and Cursor · Obsidian, Logseq, Git repos, any folder
What you get
An analysis and a visualisation of your brain, and what to fix first.
-
Tree
Your brain’s folders and files as one browsable map, each file with its own findings.
-
Constellation
Every page as a star and every link as a line: see the clusters, the bridges and what floats alone.
-
Structural audit
Dead, ambiguous and outside links, orphans, dead ends, undated and stale pages, uncited evidence.
-
Merit audit
Does the brain cover what a business like yours needs to know? Graded by your agent against our rubric.
-
Summary and score
One score out of 100 from structure and merit, with the measures behind it.
-
Top 5 fixes
The five changes that matter most, each with how to fix it by hand, then the full list file by file.
How it works
-
Connect your agent
One command adds our MCP server to Claude Code, Codex or Cursor, plus a small skill or rule that says: follow the audit’s steps exactly.
-
Confirm your email
Your agent asks for your email; we send a 6-digit code. The report link goes to the same address.
-
Your agent audits locally
It runs our npm CLI (@unabyss/brain-audit) on your folder, confirms your company type with you and grades merit. Files are read on your machine only.
-
Open your report
The CLI encrypts the detail, uploads it and gives you a private link. The key to read it is in that link, and only there.
Private by design
No content leaves your machine. Even your file names reach us only encrypted, with a key
that only you hold: it sits in your report link after the #, and we never see it.
What reaches Unabyss
- Your email, to send the confirmation code and the report link.
- The company type you confirm (for example “agency” or “tech”).
- Numbers only: file count, scores, the counts per finding category and the audit’s measures.
- The detailed report, encrypted on your machine with a key we never receive.
What never does
- The content of any file.
- File names, paths or titles in readable form: they exist on our side only inside the encrypted report.
- The key: it lives after the # in your report link, a part browsers never send to a server.
- Anything at all from the CLI except that one upload: no telemetry.
Set up your agent in a minute
Connect the MCP server, add the small skill or rule, then ask your agent to run the audit.
The skill only says: call next_step and follow it exactly.
Every step comes from the server, so you never update it.
1. Connect the MCP server
In a terminal:
claude mcp add --transport http --scope user brain-audit https://audit.unabyss.com/mcp2. Add the SKILL.md skill
A personal skill: ~/.claude/skills/brain-audit/SKILL.md, available in every project.
mkdir -p ~/.claude/skills/brain-audit && curl -fsSL https://audit.unabyss.com/agents/claude-code -o ~/.claude/skills/brain-audit/SKILL.md3. Ask your agent
Open it on (or near) your brain folder and say:
Run the Unabyss brain audit on my brain folder.
1. Connect the MCP server
In a terminal:
codex mcp add brain-audit --url https://audit.unabyss.com/mcpOr add this to
~/.codex/config.toml:[mcp_servers.brain-audit] url = "https://audit.unabyss.com/mcp"2. Add the AGENTS.md instructions
Appended to your global ~/.codex/AGENTS.md, so it applies in every folder and never lands in your brain.
curl -fsSL https://audit.unabyss.com/agents/codex >> ~/.codex/AGENTS.md3. Ask your agent
Open it on (or near) your brain folder and say:
Run the Unabyss brain audit on my brain folder.
1. Connect the MCP server
Add this to
~/.cursor/mcp.json(every project; .cursor/mcp.json for one):{ "mcpServers": { "brain-audit": { "url": "https://audit.unabyss.com/mcp" } } }2. Add the brain-audit.mdc rule
A project rule: .cursor/rules/brain-audit.mdc in the folder you open in Cursor.
mkdir -p .cursor/rules && curl -fsSL https://audit.unabyss.com/agents/cursor -o .cursor/rules/brain-audit.mdc3. Ask your agent
Open it on (or near) your brain folder and say:
Run the Unabyss brain audit on my brain folder.
MCP server: https://audit.unabyss.com/mcp (streamable HTTP, no sign-in).
Needs Node.js 20 or newer.
Questions
Any folder of Markdown or text files: a company brain, a cloned GitHub repo of docs, an Obsidian or Logseq vault, a Markdown export of a wiki. If your agent can open the folder, it can audit it.
Any size. The report shows full detail, every file as a star in the constellation, up to 10,000 files; above that the constellation groups files into areas and the rest of the report stays complete.
Nothing. The audit runs on your own agent and its tokens; the merit grading reads only a capped number of files, so the cost stays small and predictable. We run no model on your data.
Claude Code, Codex or Cursor, Node.js 20 or newer, and an email address you can read (we send a code to it).
Your agent reads your files the way it does for any task you give it, under the terms you already have with its provider. Nothing it reads is sent to Unabyss.
The report, encrypted, for 30 days. Your email as a lead for 12 months from your consent. “Delete now” on the report removes the report and your email at any time.
Yes. From the report you can invite colleagues by email; they sign in with a link sent to them. Send them the full link yourself if they should see the detail, since we never have the key.
Bring your own brain to Unabyss
Keep your brain in your own database, so your data stays yours, and run it on your own API keys.
- Ingest from the tools you already use
- Deduplication across every source
- Retrieval for people and agents
- An updating engine that keeps pages current
- Pattern recognition across your company
- Custom agents on top of the brain
Unabyss takes these off your shoulders.