garrytan /gbrain

Garry's Opinionated OpenClaw/Hermes Agent Brain

★ 33,082⑂ 4,951👁 135⑃ 5,285● 3,979▤ 799
TypeScriptMITCreated 2026-04-05
TA的项目
下载:v0.60.723.0v0.60.723.0 ↓0.60.723.02026-11-15
+113
日增长
+1,592
周增长
+2,265
月增长
33,082
stars
4,951
forks
135
watchers
5,285
prs
3,979
issues
799
releases

README

One brain for you and your company, read by every agent you use. Put your own notes and your company's docs in one place: a facts page, a decisions log, call transcripts. Claude Code, Codex and your other agents look there before they answer, so they stop starting from zero and work from what you and your team actually wrote down.

GBrain is MIT-licensed and free to self-host, and it starts with no API keys: search is by keyword until you add one. gbrain.io is optional paid hosting.

 [!TIP]
 Need hosted? First time running an agent? Try gbrain.io, hosted GBrain, for the easiest experience: one brain for you and your team, connected to ChatGPT, Claude and Cursor, with nothing to install or keep online. Stuck? Email [email protected] and a person will set it up with you, free.

A few minutes after you install it:

- Every new Claude Code or Codex session looks in your brain before it answers, without being told to.
- Anything you ask your agent to remember is still there in the next session, in every agent connected to the brain.
- Your notes and your company's docs are searchable, and your agent answers questions like "what did we decide about pricing, and why?" from them.

Works with these agents (each name links to its guide):

| How it connects | Agents |
|---|---|
| One command wires memory, hooks and instructions | Claude Code (gbrain setup claude-code), Codex (gbrain setup codex) |
| MCP from its guide, then gbrain setup  adds the brain-first instructions | OpenClaw, Hermes, opencode, Cursor |
| MCP from its guide | ChatGPT, Claude Desktop, Claude Cowork, Perplexity, Grok Build, Grok Bot, Muse, Windsurf and other stdio clients |
| Any other coding agent | Paste the install prompt below |

 Stability

New releases come out many times a day, but the install command below gives you the stable channel: a release reaches it only after the full test suite and a two-hour, 600,000-page load test pass on that exact release, and only when an important fix is waiting or stable is a week old. Updates are never installed without your say-so unless you turn on automatic upgrades. After an upgrade, gbrain shows a one-time notice listing what changed in behaviour. docs/STABILITY.md explains how often stable moves, how to pin a version or go back, and what the faster alpha channel is for.

 Install

 [!TIP]
 Fastest: hosted GBrain at gbrain.io, for any harness. One command launches a GBrain hosted on gbrain.io; Claude Code, Codex, ChatGPT, Cursor and every other AI you use connect to it, with nothing to keep online.

 bash
 curl -sSL https://gbrainio.terminalwire.sh | bash
 gbrainio terminal connect       in a new terminal
 gbrainio workspace new          pick a plan in the browser
 curl -fsSL https://bun.sh/install | bash    skip if Bun 1.4.4+ is installed
 export PATH="$HOME/.bun/bin:$PATH"
 bun install -g github:garrytan/gbrainstable    the gbrain CLI only; no local brain
  Claude Code (an existing gbrain entry is kept):
 (claude mcp get gbrain /dev/null

Top issues

Discussions

Latest release

v0.60.723.0 v0.60.723.0 2026-11-15
gbrain access rule add no longer lets a hand-typed reader list lock the brain owner out of a folder. When an owner is set, a rule whose --readers leaves the owner out is refused with readers_omit_owner, the same check and message gbrain repair visibility --readers already uses, and nothing is written. Pass --allow-without-owner when the owner really should not read it. A brain with no owner set is unchanged, and it works the same on a repo-less source (rules in the database) and a git source (.gbrain/access.yml).



 Itemized changes

- src/commands/access-rules.ts: rule add checks the owner b

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON