OpenParable
Skip to content
← Back to skills

Ob1 Local HTTP

Apps & Automation
ob1-local-http

Ob1 Local HTTP is an Agent Skill for apps & automation published in the NateBJones-Projects/OB1 repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/NateBJones-Projects/OB1/blob/HEAD/skills/ob1-local-http/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ob1-local-http, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.

Search

When the user wants to recall:

curl -fsS -X POST "$BRAIN_URL/functions/v1/search" \
  -H "apikey: $BRAIN_ANON_KEY" \
  -H "Authorization: Bearer $BRAIN_ANON_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<what to find>","match_count":10,"match_threshold":0.65}'

match_threshold defaults to 0.7. Lower it to 0.5-0.65 for broader recall; raise to 0.8+ for precision. Cap match_count at 100.

Browse recent

When the user asks "what have I been thinking about" or wants a list rather than a similarity search:

curl -fsS "$BRAIN_URL/functions/v1/list?limit=20" \
  -H "apikey: $BRAIN_ANON_KEY" \
  -H "Authorization: Bearer $BRAIN_ANON_KEY"

Output

  • For captures: confirm the id and the de-dupe fingerprint to the user in one sentence. Don't paraphrase the captured content back at them.
  • For searches: surface the top results with similarity scores and created_at timestamps. Order by similarity descending. If no results cross the threshold, say so plainly and suggest lowering it.
  • For browse: a compact bullet list with truncated content (first ~120 chars) and timestamps.

Failure Modes

  • HTTP 502 with "unable to reach Ollama": the brain host's Ollama service is down. Tell the user to docker compose ps on the brain host.
  • HTTP 502 with "did you 'ollama pull...'": the embedding model isn't loaded. Tell the user to run the documented ollama pull step.
  • HTTP 502 with "embedding-dim mismatch": the brain's EMBED_DIM env was changed after the volume was initialized. Tell the user to read the "one-way door" section of local-brain-no-mcp's README.
  • HTTP 401 or 403: BRAIN_ANON_KEY is wrong or expired. Tell the user to check supabase-docker/docker/.env on the brain host.
  • Network timeout: the brain host is unreachable. Tell the user to ping the brain host from this dev host.

Notes

  • Never log or echo BRAIN_ANON_KEY -- it's a long-lived JWT.
  • This skill never installs or invokes any MCP server, by design.
  • The brain host generates embeddings itself; this dev host doesn't need Ollama or any model files.