brainkeep
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.
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
Markdown
[](/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
- {
- "name": "brainkeep",
- "owner": {
- "name": "Brainkeep contributors"
- },
- "description": "Claude Code plugins for Brainkeep, shared memory for AI agents.",
- "plugins": [
- {
- "name": "brainkeep",
- "source": "./plugins/brainkeep",
- "description": "Brainkeep reminders for PCDD change documents and shared artifacts."
- }
- ]
- }
README.md · README · 84 lines
- # 🧠 Brainkeep
- Shared, user-controlled memory for AI agents. Brainkeep is a small MCP server
- (Rust + SQLite) that your assistants (Claude Code, claude.ai, Codex, Antigravity or
- any MCP client) use to save and recall decisions, discoveries, progress and links
- across sessions, tools and people.
- - **One memory, many agents.** Every assistant reads and writes the same projects,
- with full revision history and verified authorship.
- - **Built for teams.** Invite people by email, share projects read-only or
- read-write, revoke access instantly. Sign-in with Google over OAuth for claude.ai
- and other remote clients; fixed tokens for local agents.
- - **Small context footprint.** Compact responses and a short memory protocol the
- server sends to clients, so agents save on their own without long prompts.
- - **Safe by default.** Private files (0600), secret-shaped text (passwords, keys,
- tokens by pattern) is rejected before it is stored, per-user request limits,
- consistent backups, schema migrations with snapshots.
- - **Web panel.** Search, filters, history, diffs and live updates, with Google
- sign-in per user; edit memories (with conflict handling), archive and restore,
- and purge for project owners.
- > Status: early. Linux/macOS (Unix sockets); Windows is not supported yet.
- ## Quick start (local, single user)
- 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`:
- ```sh
- 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`.
- ## Server for a team
- Run it on any Linux host with systemd behind an HTTPS reverse proxy (Caddy, nginx,
- a tunnel). See [docs/server.md](docs/server.md): install, tokens, users and sharing,
- Google sign-in, the web panel, backups and upgrades.
- Then connect your clients: [docs/clients.md](docs/clients.md).
- ## Claude Code plugin
- The `brainkeep` plugin reminds Claude Code to record work in Brainkeep: after
- it edits a PCDD change document (`pcdd/changes/*.md`) and after
- it publishes or opens an artifact (so the link is saved for the team).
- ```text
- /plugin marketplace add aledepaoligampel/brainkeep
- /plugin install brainkeep@brainkeep
- ```
- The plugin does not configure the MCP server; connect it first. Details:
- [docs/plugin.md](docs/plugin.md).
- ## Development
- ```sh
- ./scripts/check.sh # format, clippy, tests, protocol tests
- ./scripts/check-database.sh # storage and migration tests
- cd panel-ui && npm ci --ignore-scripts && npx vite build # rebuild the web panel
- python3 scripts/build_site.py # regenerate the brainkeep.dev landing in site/
- python3 scripts/og_images.py # re-render its share images (needs Chrome)
- ```
- The landing (`site/`, served as plain files) is generated from `site-src/` and reuses the
- panel's tokens and fonts; commit its output after editing copy or markup.
- The web panel (Svelte 5 + Bits UI) is compiled into `src/panel/` and embedded in the
- binary, so servers never need Node.
- ## License
- [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 inFree to use. If it’s helped, pass it on.