Skip to content
Back to search

brainkeep

MarketplaceWorks with Claude CodeGitHub

Claude Code plugins for Brainkeep, shared memory for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/aledepaoligampel/brainkeep with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/aledepaoligampel/brainkeep'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aledepaoligampel--brainkeep/badge.svg)](/listings/aledepaoligampel--brainkeep)

HTML

<a href="/listings/aledepaoligampel--brainkeep"><img src="/api/listings/aledepaoligampel--brainkeep/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Download a [release](https://github.com/aledepaoligampel/brainkeep/releases) (macOS on Apple silicon, or Linux `aarch64`/`x86_64`), check it and put the binary on your `PATH`:

v=0.1.1; t=brainkeep-$v-aarch64-macos    # Linux: t=brainkeep-$v-$(uname -m)-linux
base=https://github.com/aledepaoligampel/brainkeep/releases/download/v$v
curl -fLO $base/$t.tar.gz && curl -fLO $base/SHA256SUMS
grep " $t.tar.gz\$" SHA256SUMS | shasum -a 256 -c
tar -xzf $t.tar.gz && mkdir -p ~/.local/bin && cp $t/brainkeep ~/.local/bin/

brainkeep --data-dir ~/.brainkeep serve &
claude mcp add brainkeep -- ~/.local/bin/brainkeep --data-dir ~/.brainkeep mcp

`serve` owns the database; `mcp` is the stdio bridge each local agent starts. The macOS binary is not notarized: download it with `curl` as above (a browser download is quarantined by Gatekeeper). To build from source instead: `cargo build --locked --release`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "brainkeep",
  3. "owner": {
  4. "name": "Brainkeep contributors"
  5. },
  6. "description": "Claude Code plugins for Brainkeep, shared memory for AI agents.",
  7. "plugins": [
  8. {
  9. "name": "brainkeep",
  10. "source": "./plugins/brainkeep",
  11. "description": "Brainkeep reminders for PCDD change documents and shared artifacts."
  12. }
  13. ]
  14. }
README.md · README · 84 lines
  1. # 🧠 Brainkeep
  2. Shared, user-controlled memory for AI agents. Brainkeep is a small MCP server
  3. (Rust + SQLite) that your assistants (Claude Code, claude.ai, Codex, Antigravity or
  4. any MCP client) use to save and recall decisions, discoveries, progress and links
  5. across sessions, tools and people.
  6. - **One memory, many agents.** Every assistant reads and writes the same projects,
  7. with full revision history and verified authorship.
  8. - **Built for teams.** Invite people by email, share projects read-only or
  9. read-write, revoke access instantly. Sign-in with Google over OAuth for claude.ai
  10. and other remote clients; fixed tokens for local agents.
  11. - **Small context footprint.** Compact responses and a short memory protocol the
  12. server sends to clients, so agents save on their own without long prompts.
  13. - **Safe by default.** Private files (0600), secret-shaped text (passwords, keys,
  14. tokens by pattern) is rejected before it is stored, per-user request limits,
  15. consistent backups, schema migrations with snapshots.
  16. - **Web panel.** Search, filters, history, diffs and live updates, with Google
  17. sign-in per user; edit memories (with conflict handling), archive and restore,
  18. and purge for project owners.
  19. > Status: early. Linux/macOS (Unix sockets); Windows is not supported yet.
  20. ## Quick start (local, single user)
  21. Download a [release](https://github.com/aledepaoligampel/brainkeep/releases) (macOS on
  22. Apple silicon, or Linux `aarch64`/`x86_64`), check it and put the binary on your `PATH`:
  23. ```sh
  24. v=0.1.1; t=brainkeep-$v-aarch64-macos # Linux: t=brainkeep-$v-$(uname -m)-linux
  25. base=https://github.com/aledepaoligampel/brainkeep/releases/download/v$v
  26. curl -fLO $base/$t.tar.gz && curl -fLO $base/SHA256SUMS
  27. grep " $t.tar.gz\$" SHA256SUMS | shasum -a 256 -c
  28. tar -xzf $t.tar.gz && mkdir -p ~/.local/bin && cp $t/brainkeep ~/.local/bin/
  29. brainkeep --data-dir ~/.brainkeep serve &
  30. claude mcp add brainkeep -- ~/.local/bin/brainkeep --data-dir ~/.brainkeep mcp
  31. ```
  32. `serve` owns the database; `mcp` is the stdio bridge each local agent starts. The macOS
  33. binary is not notarized: download it with `curl` as above (a browser download is
  34. quarantined by Gatekeeper). To build from source instead: `cargo build --locked --release`.
  35. ## Server for a team
  36. Run it on any Linux host with systemd behind an HTTPS reverse proxy (Caddy, nginx,
  37. a tunnel). See [docs/server.md](docs/server.md): install, tokens, users and sharing,
  38. Google sign-in, the web panel, backups and upgrades.
  39. Then connect your clients: [docs/clients.md](docs/clients.md).
  40. ## Claude Code plugin
  41. The `brainkeep` plugin reminds Claude Code to record work in Brainkeep: after
  42. it edits a PCDD change document (`pcdd/changes/*.md`) and after
  43. it publishes or opens an artifact (so the link is saved for the team).
  44. ```text
  45. /plugin marketplace add aledepaoligampel/brainkeep
  46. /plugin install brainkeep@brainkeep
  47. ```
  48. The plugin does not configure the MCP server; connect it first. Details:
  49. [docs/plugin.md](docs/plugin.md).
  50. ## Development
  51. ```sh
  52. ./scripts/check.sh # format, clippy, tests, protocol tests
  53. ./scripts/check-database.sh # storage and migration tests
  54. cd panel-ui && npm ci --ignore-scripts && npx vite build # rebuild the web panel
  55. python3 scripts/build_site.py # regenerate the brainkeep.dev landing in site/
  56. python3 scripts/og_images.py # re-render its share images (needs Chrome)
  57. ```
  58. The landing (`site/`, served as plain files) is generated from `site-src/` and reuses the
  59. panel's tokens and fonts; commit its output after editing copy or markup.
  60. The web panel (Svelte 5 + Bits UI) is compiled into `src/panel/` and embedded in the
  61. binary, so servers never need Node.
  62. ## License
  63. [MIT](LICENSE). Bundled fonts: SIL Open Font License, see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.