brain

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in adapters/claude-code/settings.json
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool provides a shared, local long-term memory system for AI coding agents. It saves notes and context as git commits in a local folder, which can be accessed via a command-line interface, terminal UI, or an MCP server.

Security Assessment
Overall risk: Medium. The tool accesses local files and writes to agent configuration directories, but does not request inherently dangerous system permissions. However, the automated scan detected a recursive force deletion command (`rm -rf`) inside the Claude Code adapter settings. While this might simply be intended to clean up temporary files, recursive force deletions in automated scripts are a known hazard and could accidentally delete important user data if a path variable is mishandled. The tool does not appear to make automatic network requests or contain hardcoded secrets; syncing to a remote git repository is strictly manual.

Quality Assessment
The project is very new and has low community visibility, currently sitting at only 5 GitHub stars. Despite the low visibility, it is actively maintained, with the most recent push occurring just today. The codebase is licensed under the permissive and standard Apache-2.0, and a README is properly provided with clear installation and usage instructions.

Verdict
Use with caution — the tool is actively maintained and open-source, but its low community adoption and the presence of a recursive force deletion command in its configuration files warrant a careful review before deploying in sensitive environments.
SUMMARY

Git-backed long-term memory for AI coding agents

README.md

brain

Git-backed long-term memory for AI coding agents.

Rust License MCP

brain gives Claude Code, Cursor, Codex, OpenClaw, Hermes, and MCP-capable
tools one shared local memory. Notes are stored as git commits in ~/.brain,
indexed for search, and available through the CLI, TUI, and MCP server.

Follow @Av1dlive on X

brain architecture

Install

Homebrew on macOS installs the prebuilt binary:

brew install codejunkie99/tap/brain
brain onboard

From source:

git clone https://github.com/codejunkie99/brain.git
cd brain
cargo install --path crates/brain-cli
brain onboard

First run

brain onboard

Onboarding creates or keeps ~/.brain, lets you choose which agents to wire,
shows the exact files it will write, then asks before saving. It does not
create cloud accounts, install daemons, store API keys, or send memory anywhere.

You can type agent names naturally:

claude code
wire claude code and cursor
codex openclaw hermes
all
none

Scripted setup:

brain onboard --agents all --yes
brain onboard --agents claude-code,cursor,codex --yes
brain onboard --agents openclaw,hermes --yes

Refresh managed wiring later:

brain onboard --agents all --yes --reconfigure

Use it

brain note "remember that auth uses PKCE"
brain ask "auth"
brain log
brain tui

brain tui opens the terminal dashboard.

Agent files

When selected during onboarding, brain can write:

Agent Files
Claude Code ~/.claude/mcp_servers.json, ~/.claude/CLAUDE.md
Cursor <project>/.cursor/mcp.json, <project>/.cursor/rules/brain.mdc
Codex ~/.codex/config.toml, ~/.codex/AGENTS.md
OpenClaw ~/.openclaw/workspace/BRAIN.md
Hermes <project>/AGENTS.md

Existing files are not overwritten by default. Managed prompt blocks use
BRAIN:START / BRAIN:END markers so re-runs do not duplicate content.

Sync

Sync is explicit:

brain remote add origin <url>
brain push
brain pull

Troubleshooting

brain doctor
brain doctor --deep

Use doctor --deep when search or log output looks inconsistent. It rebuilds
the local SQLite index from git without changing the source-of-truth event log.

By default, memory lives in ~/.brain. Override it with BRAIN_DIR or
--brain-dir <path>.

Commands

brain onboard
brain note "any text"
brain ask "word"
brain log
brain tui
brain doctor
brain serve --mcp
brain remote add origin <url>
brain push
brain pull

License

Apache-2.0. See LICENSE.

Yorumlar (0)

Sonuc bulunamadi