- 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 installin 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 "<query>" [--limit N]Best for: exact names, terms, file references. 适合：精确的人名、术语、文件名搜索。
Semantic search (hybrid, understands meaning) / 语义搜索
cd $GBRAIN_DIR && bun run src/cli.ts query "<question>" [--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 "<slug>" [--fuzzy]Use --fuzzy for approximate slug matching. 使用 --fuzzy 进行模糊匹配。
Knowledge Graph / 知识图谱
Create link / 创建关联
cd $GBRAIN_DIR && bun run src/cli.ts link "<from>" "<to>" [--link-type TYPE] [--context "description"]Traverse graph / 遍历图谱
cd $GBRAIN_DIR && bun run src/cli.ts graph "<slug>" [--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 --staleStatistics / 统计信息
cd $GBRAIN_DIR && bun run src/cli.ts statsHealth check / 健康检查
cd $GBRAIN_DIR && bun run src/cli.ts doctorWorkflow / 工作流程
Adding new content / 添加新内容
- Add markdown files to
$BRAIN_DIR/sources/<category>/ git add && git commit- Run
sync --full --no-pull --no-embed - Run
embed --stale
Typical search pattern / 典型搜索模式
- Start with
searchfor exact matches - If no results or need deeper understanding, use
query - Use
get <slug>to read full page content - Use
graph <slug>to explore related pages
Tips / 提示
searchis faster,queryis smarter — usesearchfirst /search更快，query更智能- Add
--limit 5for concise results / 加--limit 5获取简洁结果 - Use
--fuzzywhen unsure of exact slug / 不确定 slug 时用--fuzzy - For embedding issues with large files (>64 chunks), split into smaller files / 大文件嵌入失败时，拆分为小文件
- Run
statsperiodically to check brain health / 定期运行stats检查知识库状态