ob1-local-http

Capture and search thoughts against a self-hosted Open Brain over HTTPS using curl.

4.5k|872|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/NateBJones-Projects/OB1 --skill ob1-local-http
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ob1-local-http
Source: https://github.com/NateBJones-Projects/OB1/tree/main/skills/ob1-local-http
Command: npx skills add https://github.com/NateBJones-Projects/OB1 --skill ob1-local-http

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

In environments where Claude Code's MCP feature is disabled (corporate networks, locked-down builds, restricted networks), the canonical Open Brain capture and search tools stop working. This Skill restores personal memory capture and recall by calling a LAN-resident Open Brain stack directly over authenticated HTTPS with curl, no MCP transport involved.

Core Features & Use Cases

  • Thought Capture: Send "remember this" style requests to the brain's capture endpoint, with server-side fingerprinting and de-duplication returning confirmation ids.
  • Semantic Search: Query the brain's search endpoint with tunable match thresholds and result counts to recall previously saved thoughts, score-ordered.
  • Browse Recent Thoughts: List recent captures in time order for prompts like "what have I been thinking about".
  • Use Case: On a corporate laptop where MCP is blocked, ask your AI coding tool "what did I note about the Apex deal" and get similarity-ranked results from your self-hosted brain via plain curl.

Quick Start

Export BRAIN_URL and BRAIN_ANON_KEY from your local-brain-no-mcp deployment, then ask your AI tool to remember a thought or search your brain for a topic.

Frequently Asked Questions about ob1-local-http

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture and search thoughts without MCP in Claude Code?

Use curl against the Open Brain edge functions: POST to /functions/v1/capture with the thought content, and POST to /functions/v1/search with a query, match_count, and match_threshold. Both calls authenticate with the apikey and Authorization Bearer headers using BRAIN_ANON_KEY.

How do I set up the Open Brain local HTTP skill?

Deploy the local-brain-no-mcp recipe on a LAN host, then export BRAIN_URL and BRAIN_ANON_KEY on your dev host. Copy the skill directory into your AI tool's skills directory and verify reachability with a curl call to the list endpoint expecting HTTP 200.

Can I use Open Brain when MCP is disabled or blocked?

Yes. This skill is the documented HTTP-only fallback for environments where MCP is disabled by corporate policy or network restrictions. It performs capture, search, and browse purely via curl against the LAN-resident brain stack.

Why does the Open Brain search return HTTP 502 errors?

HTTP 502 usually indicates an Ollama problem on the brain host: the service is down, the embedding model was not pulled, or EMBED_DIM was changed after volume initialization. Run docker compose ps on the brain host and follow the local-brain-no-mcp README.

When should I not use the local HTTP fallback for Open Brain?

Do not use it when a working remote Open Brain MCP connection exists, since the canonical MCP-based tools are preferred. It also cannot function without BRAIN_URL and BRAIN_ANON_KEY exported on the dev host.