https://github.com/codejunkie99/brain
Git-backed long-term memory for AI coding agents
https://github.com/codejunkie99/brain
agent-memory ai-agents cli git mcp rust sqlite tui
Last synced: about 2 months ago
JSON representation
Git-backed long-term memory for AI coding agents
- Host: GitHub
- URL: https://github.com/codejunkie99/brain
- Owner: codejunkie99
- License: apache-2.0
- Created: 2026-04-27T11:01:58.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T07:15:57.000Z (about 2 months ago)
- Last Synced: 2026-05-01T18:19:56.230Z (about 2 months ago)
- Topics: agent-memory, ai-agents, cli, git, mcp, rust, sqlite, tui
- Language: Rust
- Size: 150 KB
- Stars: 33
- Watchers: 2
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# 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:
```bash
brew install codejunkie99/tap/brain
brain onboard
```
From source:
```bash
git clone https://github.com/codejunkie99/brain.git
cd brain
cargo install --path crates/brain-cli
brain onboard
```
## First run
```bash
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:
```text
claude code
wire claude code and cursor
codex openclaw hermes
all
none
```
Scripted setup:
```bash
brain onboard --agents all --yes
brain onboard --agents claude-code,cursor,codex --yes
brain onboard --agents openclaw,hermes --yes
```
Refresh managed wiring later:
```bash
brain onboard --agents all --yes --reconfigure
```
## Use it
```bash
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 | `/.cursor/mcp.json`, `/.cursor/rules/brain.mdc` |
| Codex | `~/.codex/config.toml`, `~/.codex/AGENTS.md` |
| OpenClaw | `~/.openclaw/workspace/BRAIN.md` |
| Hermes | `/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:
```bash
brain remote add origin
brain push
brain pull
```
## Troubleshooting
```bash
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 `.
## Commands
```bash
brain onboard
brain note "any text"
brain ask "word"
brain log
brain tui
brain doctor
brain serve --mcp
brain remote add origin
brain push
brain pull
```
## License
Apache-2.0. See [LICENSE](LICENSE).