{"id":49472851,"url":"https://github.com/codejunkie99/brain","last_synced_at":"2026-05-03T20:01:16.496Z","repository":{"id":354234962,"uuid":"1222427087","full_name":"codejunkie99/brain","owner":"codejunkie99","description":"Git-backed long-term memory for AI coding agents","archived":false,"fork":false,"pushed_at":"2026-04-28T07:15:57.000Z","size":154,"stargazers_count":33,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-01T18:19:56.230Z","etag":null,"topics":["agent-memory","ai-agents","cli","git","mcp","rust","sqlite","tui"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codejunkie99.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-27T11:01:58.000Z","updated_at":"2026-05-01T14:44:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codejunkie99/brain","commit_stats":null,"previous_names":["codejunkie99/brain"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/codejunkie99/brain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codejunkie99%2Fbrain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codejunkie99%2Fbrain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codejunkie99%2Fbrain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codejunkie99%2Fbrain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codejunkie99","download_url":"https://codeload.github.com/codejunkie99/brain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codejunkie99%2Fbrain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32545870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-memory","ai-agents","cli","git","mcp","rust","sqlite","tui"],"created_at":"2026-04-30T17:30:26.789Z","updated_at":"2026-05-02T19:01:38.888Z","avatar_url":"https://github.com/codejunkie99.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# brain\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eGit-backed long-term memory for AI coding agents.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Rust\" src=\"https://img.shields.io/badge/rust-1.85%2B-f97316?logo=rust\u0026logoColor=white\"\u003e\n  \u003cimg alt=\"License\" src=\"https://img.shields.io/badge/license-Apache--2.0-blue\"\u003e\n  \u003cimg alt=\"MCP\" src=\"https://img.shields.io/badge/MCP-ready-6d5dfc\"\u003e\n\u003c/p\u003e\n\n`brain` gives Claude Code, Cursor, Codex, OpenClaw, Hermes, and MCP-capable\ntools one shared local memory. Notes are stored as git commits in `~/.brain`,\nindexed for search, and available through the CLI, TUI, and MCP server.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://x.com/Av1dlive\"\u003eFollow @Av1dlive on X\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/architecture.svg\" alt=\"brain architecture\" width=\"920\"\u003e\n\u003c/p\u003e\n\n## Install\n\nHomebrew on macOS installs the prebuilt binary:\n\n```bash\nbrew install codejunkie99/tap/brain\nbrain onboard\n```\n\nFrom source:\n\n```bash\ngit clone https://github.com/codejunkie99/brain.git\ncd brain\ncargo install --path crates/brain-cli\nbrain onboard\n```\n\n## First run\n\n```bash\nbrain onboard\n```\n\nOnboarding creates or keeps `~/.brain`, lets you choose which agents to wire,\nshows the exact files it will write, then asks before saving. It does not\ncreate cloud accounts, install daemons, store API keys, or send memory anywhere.\n\nYou can type agent names naturally:\n\n```text\nclaude code\nwire claude code and cursor\ncodex openclaw hermes\nall\nnone\n```\n\nScripted setup:\n\n```bash\nbrain onboard --agents all --yes\nbrain onboard --agents claude-code,cursor,codex --yes\nbrain onboard --agents openclaw,hermes --yes\n```\n\nRefresh managed wiring later:\n\n```bash\nbrain onboard --agents all --yes --reconfigure\n```\n\n## Use it\n\n```bash\nbrain note \"remember that auth uses PKCE\"\nbrain ask \"auth\"\nbrain log\nbrain tui\n```\n\n`brain tui` opens the terminal dashboard.\n\n## Agent files\n\nWhen selected during onboarding, `brain` can write:\n\n| Agent | Files |\n|---|---|\n| Claude Code | `~/.claude/mcp_servers.json`, `~/.claude/CLAUDE.md` |\n| Cursor | `\u003cproject\u003e/.cursor/mcp.json`, `\u003cproject\u003e/.cursor/rules/brain.mdc` |\n| Codex | `~/.codex/config.toml`, `~/.codex/AGENTS.md` |\n| OpenClaw | `~/.openclaw/workspace/BRAIN.md` |\n| Hermes | `\u003cproject\u003e/AGENTS.md` |\n\nExisting files are not overwritten by default. Managed prompt blocks use\n`BRAIN:START` / `BRAIN:END` markers so re-runs do not duplicate content.\n\n## Sync\n\nSync is explicit:\n\n```bash\nbrain remote add origin \u003curl\u003e\nbrain push\nbrain pull\n```\n\n## Troubleshooting\n\n```bash\nbrain doctor\nbrain doctor --deep\n```\n\nUse `doctor --deep` when search or log output looks inconsistent. It rebuilds\nthe local SQLite index from git without changing the source-of-truth event log.\n\nBy default, memory lives in `~/.brain`. Override it with `BRAIN_DIR` or\n`--brain-dir \u003cpath\u003e`.\n\n## Commands\n\n```bash\nbrain onboard\nbrain note \"any text\"\nbrain ask \"word\"\nbrain log\nbrain tui\nbrain doctor\nbrain serve --mcp\nbrain remote add origin \u003curl\u003e\nbrain push\nbrain pull\n```\n\n## License\n\nApache-2.0. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodejunkie99%2Fbrain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodejunkie99%2Fbrain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodejunkie99%2Fbrain/lists"}