# Ob1 Local Http

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

- Repository: https://github.com/NateBJones-Projects/OB1 (4752 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -g -a claude-code -y`
Codex: `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -g -a codex -y`
Cursor: `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -g -a cursor -y`
Gemini CLI: `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

```sh
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":

```sh
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.

The rest: https://github.com/NateBJones-Projects/OB1/blob/HEAD/skills/ob1-local-http/SKILL.md