Gbrain Multi-Agent Search

---

name: gbrain-multi-agent-search description: "Search and manage a local gbrain personal knowledge base (full-text search, semantic search, knowledge graph). Use when searching personal notes, emails, documents, diary entries, or any knowledge stored in gbrain. Triggers: search brain, query brain, find in brain, brain search, gbrain, knowledge base search, personal knowledge, 知识库搜索, 脑库查询, 记忆搜索, 搜索知识库, 查询脑库."

---

Gbrain Multi-Agent Search

Local knowledge base with full-text search, semantic search, and knowledge graph. Requires gbrain installed and a brain repo initialized.

Prerequisites

gbrain CLI installed (bun install in gbrain repo)

A brain repo with synced markdown content

Embedding API configured (OpenAI-compatible endpoint)

Configuration / 配置

Set these variables or replace inline:

| Variable | Description | 示例 | |----------|-------------|------| | GBRAIN_DIR | Path to gbrain source repo | ~/gbrain | | BRAIN_DIR | Path to brain content repo | ~/brain | | OPENAI_API_KEY | Embedding API key | sk-... | | OPENAI_BASE_URL | Embedding API base URL | https://api.openai.com/v1 |

One-liner setup (add to TOOLS.md)

export GBRAIN_DIR=~/gbrain
export BRAIN_DIR=~/brain
export OPENAI_API_KEY=your-key-here
export OPENAI_BASE_URL=https://api.openai.com/v1
alias gb="cd $GBRAIN_DIR && bun run src/cli.ts"

Search / 搜索

Keyword search (fast, exact match) / 关键词搜索

cd $GBRAIN_DIR && bun run src/cli.ts search "" [--limit N]

Best for: exact names, terms, file references. 适合：精确的人名、术语、文件名搜索。

Semantic search (hybrid, understands meaning) / 语义搜索

cd $GBRAIN_DIR && bun run src/cli.ts query "" [--limit N]

Best for: natural language questions, fuzzy concepts, cross-topic queries. 适合：自然语言提问、模糊概念、跨主题查询。

Examples / 示例:

query "When did I join company X"        / "什么时候加入的公司X"
query "Heart rate trends in 2024"         / "2024年心率趋势"
query "Email about project approval"      / "项目审批相关的邮件"

List pages / 列出页面

cd $GBRAIN_DIR && bun run src/cli.ts list [--type source|person|concept|company|project|deal|media|civic] [--tag T] [-n N]

Read a page / 读取页面

cd $GBRAIN_DIR && bun run src/cli.ts get "" [--fuzzy]

Use --fuzzy for approximate slug matching. 使用 --fuzzy 进行模糊匹配。

Knowledge Graph / 知识图谱

Create link / 创建关联

cd $GBRAIN_DIR && bun run src/cli.ts link "" "" [--link-type TYPE] [--context "description"]

Traverse graph / 遍历图谱

cd $GBRAIN_DIR && bun run src/cli.ts graph "" [--depth N]

Common link types / 常用关联类型

works_at, invested_in, related_to, wrote, attended, located_in, managed, friend_of, reported_to, parent_of, spouse_of

Data Management / 数据管理

Import & embed / 导入与嵌入

# Sync markdown files from repo to brain
cd $GBRAIN_DIR && bun run src/cli.ts sync --repo $BRAIN_DIR --no-pull --no-embed --full
Generate embeddings for new/changed content
cd $GBRAIN_DIR && OPENAI_API_KEY=... OPENAI_BASE_URL=... bun run src/cli.ts embed --stale

Statistics / 统计信息

cd $GBRAIN_DIR && bun run src/cli.ts stats

Health check / 健康检查

cd $GBRAIN_DIR && bun run src/cli.ts doctor

Workflow / 工作流程

Adding new content / 添加新内容

1. Add markdown files to $BRAIN_DIR/sources// 2. git add && git commit 3. Run sync --full --no-pull --no-embed 4. Run embed --stale

Typical search pattern / 典型搜索模式

1. Start with search for exact matches 2. If no results or need deeper understanding, use query 3. Use get to read full page content 4. Use graph to explore related pages

Tips / 提示

search is faster, query is smarter — use search first / search 更快，query 更智能

Add --limit 5 for concise results / 加 --limit 5 获取简洁结果

Use --fuzzy when unsure of exact slug / 不确定 slug 时用 --fuzzy

For embedding issues with large files (>64 chunks), split into smaller files / 大文件嵌入失败时，拆分为小文件

Run stats periodically to check brain health / 定期运行 stats 检查知识库状态

gbrain CLI installed (bun install in gbrain repo)

A brain repo with synced markdown content

Embedding API configured (OpenAI-compatible endpoint)