Skills

Ob1 Local Http

Capture and search thoughts against a self-hosted Open Brain over plain HTTPS, with no...

Install

npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -g -a claude-code -y
Category
AI and agents
Updated
3d ago
License
See repository
Context cost
Lightabout 1,030 tokens
Runs scripts
No, instructions only

What it does

Capture and search thoughts against a self-hosted Open Brain over plain HTTPS, with no MCP transport involved. Use this skill in environments where Claude Code's MCP feature is disabled or the network blocks remote MCP endpoints, but the brain stack from the companion `local-brain-no-mcp` recipe is reachable on the local network. Triggers: prompts like "remember this", "save that for later", "what did I note about X", "search my brain for Y", "what thoughts touched on Z", or any explicit request to record or recall personal memory.

OB1 Local HTTP

Problem

The canonical Open Brain stack assumes Claude Code can talk to a remote Supabase MCP server. In environments that disable MCP entirely -- corporate networks, air-gapped offices, restricted Claude Code builds -- that path is not available. This skill replaces it with curl calls to a LAN-resident Open Brain (see the local-brain-no-mcp recipe), keeping the same capture-and-recall behavior without any MCP protocol involvement.

When to Use

  • The user wants to remember, record, save, capture, or note something.
  • The user wants to search, recall, retrieve, find, or look up something they previously captured.
  • The user wants to see recent thoughts (e.g. "what have I been thinking about", "show me today's notes").

When Not to Use

  • The environment has a working remote Open Brain MCP connection -- prefer the canonical MCP-based capture/search tools.
  • The required environment variables BRAIN_URL and BRAIN_ANON_KEY are not set on the dev host -- this skill cannot function without them; ask the user to follow local-brain-no-mcp's install instructions first.

Required Environment

On each dev host that will use this skill, the user must export:

export BRAIN_URL="http://<brain-host>:8000"   # Supabase Kong gateway
export BRAIN_ANON_KEY="eyJhbGciOi..."          # written by setup.sh

If either is missing, stop and tell the user. Do not guess values.

Process

Capture

When the user says something like "remember X" or "save this thought":

curl -fsS -X POST "$BRAIN_URL/functions/v1/capture" \
  -H "apikey: $BRAIN_ANON_KEY" \
  -H "Authorization: Bearer $BRAIN_ANON_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"<the thought>","metadata":{"source":"claude-code"}}'

Optional metadata fields: source, tags (array of strings), thread_id, anything else useful. The server fingerprints content and de-duplicates -- re-capturing identical text returns the existing id.

Read the whole SKILL.md on GitHub

More in AI and agents