brain
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
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.
Git-backed long-term memory for AI coding agents
brain
Git-backed long-term memory for AI coding agents.
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.
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 useBRAIN: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)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi