Agent skill

Open Brain Local HTTP

by NateBJones-Projects in NateBJones-Projects/OB1

Captures and searches personal notes in a self-hosted Open Brain using plain curl calls over HTTP, for setups where MCP is disabled or blocked.

Custom licenceAuto-check: notesAgent Workflows

Install Open Brain Local HTTP

skills CLI
$ npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install NateBJones-Projects/OB1 ob1-local-http --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/NateBJones-Projects/OB1.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ob1-local-http .claude/skills/ob1-local-http && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ob1-local-http
GitHub stars
4.7k
Token cost
~1.2k tokens
SKILL.md length
495 words
Files
3
Skills in repo
24
Repo updated
First seen
Licence
Custom licence

At a glance

Captures and searches personal notes in a self-hosted Open Brain using plain curl calls over HTTP, for setups where MCP is disabled or blocked.

  • Saving a thought or note to a self-hosted Open Brain without MCP
  • SKILL.md covers Problem, When to Use, When Not to Use and Required Environment, plus 4 more sections
  • Calls curl, docker and ollama; needs BRAIN_ANON_KEY
  • Searching previously captured notes by meaning

What it does

Where Claude Code's MCP support is turned off or the network blocks remote MCP endpoints, this skill replaces the usual Open Brain connection with curl calls to a brain running on the local network, set up by the companion local-brain-no-mcp recipe. It keeps the same behavior: saving a thought, recalling one and listing recent ones.

Two environment variables, BRAIN_URL and BRAIN_ANON_KEY, must be exported on the dev host; if either is missing the agent stops and asks you to follow the recipe's install steps rather than guessing. Capture posts text to the capture function with optional metadata such as source, tags and thread ID, and the server fingerprints content, so saving identical text again returns the existing ID. Search posts a query with a match threshold that defaults to 0.7, lowered to between 0.5 and 0.65 for broader recall, raised to 0.8 or more for precision, with the match count capped at 100. A list call shows recent items.

When your agent uses it

  • Saving a thought or note to a self-hosted Open Brain without MCP
  • Searching previously captured notes by meaning
  • Listing recent captured thoughts

Example prompts

  • “Remember that the Q3 planning meeting moved to Thursday.”
  • “What did I note about the vendor contract last month?”
  • “Show me what I have been thinking about today.”

Requirements

  • A self-hosted Open Brain stack reachable on the local network
  • BRAIN_URL and BRAIN_ANON_KEY environment variables
  • curl

What it can do on your machine

Read from SKILL.md and the folder at commit 238df6c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • docker
    • ollama

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl and docker, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BRAIN_ANON_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Open Brain Local HTTP loads about 1.2k tokens when it runs. Until then it costs about 138 tokens; SKILL.md has 495 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~138
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:118
    check `supabase-docker/docker/.env` on the brain host.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 495 words (~1,188 tokens).

“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…”

— opening of SKILL.md by NateBJones-Projects, Custom licence
name
ob1-local-http
author
dhanjit
version
0.1.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in skills/ob1-local-http of NateBJones-Projects/OB1.

  • SKILL.md
  • README.md
  • metadata.json

Open the folder on GitHubat commit 238df6c

Compare with similar skills

Open Brain Local HTTP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Open Brain Local HTTP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Open Brain Local HTTP this skillNateBJones-Projects/OB14.7k—~1.2kAutomated safety check: NotesCustom licence
Agent RecallGoldentrii/AgentRecall-X371—~5.2kAutomated safety check: NotesMIT
Basic Memory Onboardingbasicmachines-co/basic-memory4.1k—~3.4kAutomated safety check: PassAGPL-3.0
ZhiguiCarlWangChina/zhigui-openclaw-ui-second-brain-skill103—~9.6kAutomated safety check: WarnCustom licence
Open Second Brainitechmeat/open-second-brain430—~1.2kAutomated safety check: PassMIT
Arkcli Helpervolcengine/ark-cli140—~5.3kAutomated safety check: NotesApache-2.0

Similar skills

  • Agent Recall

    Goldentrii/AgentRecall-X

    Persistent compounding memory for AI agents. An agent skill from Goldentrii/AgentRecall-X.

    371 GitHub stars~5.2k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check: notes
  • Basic Memory Onboarding

    basicmachines-co/basic-memory

    Guides a newcomer to Basic Memory through designing a personal knowledge system, then teaches its use and sets up their assistant to load it each session.

    4.1k GitHub stars~3.4k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Zhigui

    CarlWangChina/zhigui-openclaw-ui-second-brain-skill

    Personal assistant workflow for durable memory, connected actions, decisions, planning and review.

    103 GitHub stars~9.6k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check: warnings
  • Open Second Brain

    itechmeat/open-second-brain

    Lets an agent read, write and maintain its own memory in a Brain folder of an Obsidian-compatible vault, while keeping the user's own notes read-only.

    430 GitHub stars~1.2k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Arkcli Helper

    volcengine/ark-cli

    arkcli helper:为 Claude Code / Codex / OpenCode / OpenClaw / Hermes / ZCode 配置火山方舟 Plan 或 Platform Endpoint 的 model/provider,或给支持的 Agent(含 MCP-only Trae)配置 Harness 工具。真人 TTY 运行 arkcli helper 可选择模型和…

    140 GitHub stars~5.3k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check: notes
  • Swarmvault

    swarmclawai/swarmvault

    Use SwarmVault when the user needs a local-first knowledge vault that writes durable markdown, graph, search, dashboard, review, chat-session, context-pack, task-ledger, static AI export, retrieval…

    708 GitHub stars~6.1k tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed

More from NateBJones-Projects/OB1

All 24 skills in this repo
  • Heavy File Ingestion

    NateBJones-Projects/OB1

    Converts large PDF, DOCX, PPTX, XLSX and CSV files into markdown or CSV plus an index before the agent reads them, so tokens go to the compressed copy.

    4.7k GitHub stars~995 tokensUpdated yesterday
    Auto-check passed
  • Aiception Skill Extraction

    NateBJones-Projects/OB1

    Pulls reusable knowledge out of work sessions and turns it into new skills, checking existing notes and skills first to avoid duplicates.

    4.7k GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes
  • Claude Code Auto-Capture Hook

    NateBJones-Projects/OB1

    Fires a Stop hook that captures a Claude Code session transcript automatically when the session ends without a verbal wrap-up.

    4.7k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check: notes
  • Panning for Gold

    NateBJones-Projects/OB1

    Processes voice transcripts and brain dumps in three phases, extracting every idea thread, evaluating the strongest and saving a permanent inventory and synthesis.

    4.7k GitHub stars~5k tokensUpdated yesterday
    Auto-check passed
  • Agentic Harness Design and Review

    NateBJones-Projects/OB1

    Designs, evaluates and improves the harness around an AI agent: tool permissions, approval gates, state, memory, evals and observability, with phased plans.

    4.7k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Weekly Signal Diff

    NateBJones-Projects/OB1

    Turns a noisy week of AI or software market news into a short list of structural changes, weighted by what the user already tracks in Open Brain memory.

    4.7k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Open Brain Local HTTP

What does Open Brain Local HTTP do?

Captures and searches personal notes in a self-hosted Open Brain using plain curl calls over HTTP, for setups where MCP is disabled or blocked. Where Claude Code's MCP support is turned off or the network blocks remote MCP endpoints, this skill replaces the usual Open Brain connection with curl calls to a brain running on the local network, set up by the companion local-brain-no-mcp recipe. It keeps the same behavior: saving a thought, recalling one and listing recent ones.

When should I use Open Brain Local HTTP?

Open Brain Local HTTP fits situations like: saving a thought or note to a self-hosted Open Brain without MCP; searching previously captured notes by meaning; listing recent captured thoughts.

How do I install Open Brain Local HTTP in Claude Code?

Run `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -a claude-code`. Or copy the skill folder (skills/ob1-local-http in NateBJones-Projects/OB1) into .claude/skills/ob1-local-http in your project. Claude Code loads it when a task matches its description.

How do I install Open Brain Local HTTP in Codex?

Run `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -a codex`. Or copy the skill folder (skills/ob1-local-http in NateBJones-Projects/OB1) into .agents/skills/ob1-local-http in your project. Codex loads it when a task matches its description.

Can I use Open Brain Local HTTP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NateBJones-Projects/OB1 --skill ob1-local-http -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ob1-local-http, .gemini/skills/ob1-local-http, .github/skills/ob1-local-http and .opencode/skills/ob1-local-http in your project.

What does Open Brain Local HTTP need to run?

Going by SKILL.md and its folder, Open Brain Local HTTP needs the command-line tools its instructions call (curl, docker and ollama) and credentials named BRAIN_ANON_KEY. Our summary lists: A self-hosted Open Brain stack reachable on the local network; BRAIN_URL and BRAIN_ANON_KEY environment variables; curl.

Does Open Brain Local HTTP access the network?

SKILL.md contains no URLs. Its commands use curl and docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Open Brain Local HTTP safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Open Brain Local HTTP use?

Open Brain Local HTTP has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Open Brain Local HTTP use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Open Brain Local HTTP?

Skills that share tags, products or a category with Open Brain Local HTTP: Agent Recall (Goldentrii/AgentRecall-X, 371 stars), Basic Memory Onboarding (basicmachines-co/basic-memory, 4.1k stars), Zhigui (CarlWangChina/zhigui-openclaw-ui-second-brain-skill, 103 stars) and Open Second Brain (itechmeat/open-second-brain, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Open Brain Local HTTP?

NateBJones-Projects (a GitHub organization) maintains it in NateBJones-Projects/OB1, which has 4,685 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

Source: NateBJones-Projects/OB1 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.