Brain Search
/install brain-search
Skill: brain-search
CRITICAL RULE — NO FABRICATION
You MUST actually execute every curl command using your shell/exec tool. Read the real HTTP response. NEVER generate a fake response, placeholder ID, or simulated output. If the API call fails, report the actual error to Boss Man. If you cannot execute shell commands right now, say so — do not pretend you ran them.
Purpose
Search and interact with Frank's Second Brain — the persistent knowledge base that stores conversation logs, research, journal entries, job results, and long-term memory.
When to Use
- Boss Man asks "what did we talk about on Monday?" or "find that research on X"
- You need context from previous sessions or completed jobs
- Logging noteworthy activity outside of normal Telegram conversation
- Checking job queue status or delegating tasks to sub-agents
- Creating, updating, or managing tasks on the Kanban board
API Base
https://second-brain-chi-umber.vercel.app
All requests require header: x-api-key: frank-sb-2026
Search Entries
Find past conversations, research, notes, and logged activity.
curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=SEARCH_TERM&limit=10" \
-H "x-api-key: frank-sb-2026"
Search with Tag Filter
curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=SEARCH_TERM&tag=TAG_NAME&limit=10" \
-H "x-api-key: frank-sb-2026"
Common tags: daily-journal, telegram, research, market-analysis, advisory-council
Create Entry
Store a new knowledge entry (research results, analysis, etc.).
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/entries" \
-H "x-api-key: frank-sb-2026" \
-H "Content-Type: application/json" \
-d '{
"title": "Entry Title",
"content": "Full content here",
"tags": ["tag1", "tag2"],
"source": "telegram-frank"
}'
Log Activity
Record noteworthy events, decisions, or results.
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/log" \
-H "x-api-key: frank-sb-2026" \
-H "Content-Type: application/json" \
-d '{
"action": "ACTION_TYPE",
"summary": "Brief description of what happened",
"source": "telegram-frank",
"details": {}
}'
Kanban Board — Tasks
Create a Task
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/tasks" \
-H "x-api-key: frank-sb-2026" \
-H "Content-Type: application/json" \
-d '{
"title": "Task Title",
"description": "What needs to be done",
"status": "backlog",
"priority": "medium",
"tags": ["tag1"]
}'
Valid statuses: backlog, in_progress, done
Valid priorities: low, medium, high
Note: project_id is validated — create projects first via POST /api/projects before referencing them.
Update Task Status (Move on Kanban)
curl -s -X PATCH "https://second-brain-chi-umber.vercel.app/api/tasks/TASK_ID" \
-H "x-api-key: frank-sb-2026" \
-H "Content-Type: application/json" \
-d '{"status": "in_progress"}'
List Tasks
curl -s "https://second-brain-chi-umber.vercel.app/api/tasks?status=backlog&limit=20" \
-H "x-api-key: frank-sb-2026"
Check Activity Log
curl -s "https://second-brain-chi-umber.vercel.app/api/activity" \
-H "x-api-key: frank-sb-2026"
File Storage
Upload a File
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/upload" \
-H "x-api-key: frank-sb-2026" \
-F "file=@/path/to/file.jpg" \
-F "title=My File" \
-F "tags=upload,test"
Optional fields: entry_id, title, tags, description. If no entry_id, auto-creates a file type entry.
List Files
curl -s "https://second-brain-chi-umber.vercel.app/api/files?limit=50" \
-H "x-api-key: frank-sb-2026"
Filters: ?category=image|video|audio|document, ?stats=true
List Attachments on an Entry
curl -s "https://second-brain-chi-umber.vercel.app/api/entries/ENTRY_ID/attachments" \
-H "x-api-key: frank-sb-2026"
Delete a File
curl -s -X DELETE "https://second-brain-chi-umber.vercel.app/api/attachments/ATTACHMENT_ID" \
-H "x-api-key: frank-sb-2026"
Job Queue (Delegate to Sub-Agents)
Create Job (Delegate)
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/jobs" \
-H "x-api-key: frank-sb-2026" \
-H "Content-Type: application/json" \
-d '{
"type": "JOB_TYPE",
"title": "Job Title",
"description": "Detailed instructions",
"priority": "normal",
"tags": ["TAG"],
"input": {}
}'
Routing Tags for Sub-Agents
| Tags | Picked Up By | Best For |
|---|---|---|
["claude", "code"] |
Claude Opus 4.5 | Coding, architecture, debugging |
["claude", "write"] |
Claude Sonnet 4.5 | LinkedIn posts, articles, email drafts |
| (no claude tag) | MiniMax M2.5 | Research, analysis, batch ops (cheapest) |
Check Job Status
curl -s "https://second-brain-chi-umber.vercel.app/api/jobs/JOB_ID" \
-H "x-api-key: frank-sb-2026"
List Running Jobs
curl -s "https://second-brain-chi-umber.vercel.app/api/jobs?status=running&stats=true" \
-H "x-api-key: frank-sb-2026"
Rules
- EXECUTE EVERY CURL COMMAND FOR REAL — use your shell/exec tool. Never simulate or fabricate API responses.
- Always include
x-api-key: frank-sb-2026header - Always report the actual HTTP response back to Boss Man
- If an API call fails, show the error — don't make up a success message
- Boss Man watches the /jobs page and Kanban board live — he will see if you fake it
- When delegating: create job as pending → sub-agent picks it up → updates to running → completed
- For multi-step tasks, ALWAYS use the job queue rather than doing everything inline
- Log activity for anything noteworthy that happens outside of normal Telegram chat
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install brain-search - 安装完成后,直接呼叫该 Skill 的名称或使用
/brain-search触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Brain Search 是什么?
Search, retrieve, log, and manage past conversations, research, and job tasks in Frank's persistent Second Brain knowledge base. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 786 次。
如何安装 Brain Search?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install brain-search」即可一键安装,无需额外配置。
Brain Search 是免费的吗?
是的,Brain Search 完全免费(开源免费),可自由下载、安装和使用。
Brain Search 支持哪些平台?
Brain Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Brain Search?
由 ryandeangraves(@ryandeangraves)开发并维护,当前版本 v1.1.0。