plugin 0.2.2

2026-06-05 00:49:20 -05:00
parent 67acf8fd52
commit d37b248747
115 changed files with 5565 additions and 0 deletions
@@ -0,0 +1,59 @@
+# goldbrain-memory
+
+Persistent memory for Claude via the **goldbrain** Obsidian vault, using the [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api).
+
+Reads and writes notes across Claude/CoWork sessions using direct REST calls — no MCP server required. Built for **Bryan Gilliom** (CEO, Message Point Media) as the primary operator; Jason is the vault architect.
+
+## What it does
+
+- Loads operator preferences, current context, and relevant project notes at the start of substantive conversations
+- Writes facts, preferences, and decisions Bryan asks Claude to remember
+- Logs working sessions so future conversations can pick up where they left off
+- Defers to the vault's own `BOOTSTRAP.md` to verify and repair structure on first use
+
+## Configuration
+
+The plugin is hardcoded for:
+
+- **Server:** `https://goldbrainapi.mpm.to` (reverse proxy → Obsidian Local REST API on `192.168.86.15:27124`)
+- **API Key:** stored in the skill (personal plugin, not for distribution)
+
+The endpoint presents a **valid TLS certificate**, so `-k` is not required. The bearer key lives only in the plugin — never inside the vault (per the vault's own safety rules).
+
+## Vault layout (root-addressed)
+
+```
+/vault/
+├── CLAUDE.md  STRUCTURE.md  BOOTSTRAP.md  spinup.md  index.md  README.md
+├── inbox/        (captures, imports, processing-log)
+├── journal/      (daily, weekly, monthly, templates)
+├── projects/     (active, incubating, on-hold, archived)
+├── areas/        (business, personal, learning, systems)
+├── resources/    (concepts, references, people, meetings, source-material)
+├── decisions/    (by-date, by-project)
+├── reviews/      (weekly, monthly, quarterly, annual)
+├── archive/      (notes, projects, imports)
+└── _agent/
+    ├── context/        ← task-scoped context bundles
+    ├── memory/         ← working / episodic / semantic
+    ├── sessions/       ← YYYY-MM-DD-HHMM-<slug>.md
+    ├── templates/      ← canonical note templates
+    ├── outputs/        ← briefs / drafts / summaries / synthesis
+    ├── skills/         ← active / archived
+    └── heartbeat/
+```
+
+## First run
+
+The vault ships its own `BOOTSTRAP.md`. On first use the skill reads `/vault/BOOTSTRAP.md`; if present it follows that preflight, and if absent (a fresh empty vault) it offers to bootstrap.
+
+## Skills
+
+| Skill | Triggers |
+|-------|----------|
+| `goldbrain-memory` | "remember that", "save to memory", "what do you know about me", "load my profile", "check my notes", "log this decision", "add to my inbox" — and proactively at the start of substantive conversations |
+
+## Requirements
+
+- Obsidian running on the backend with the [Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api) enabled (binding host `0.0.0.0`)
+- HTTPS access to `https://goldbrainapi.mpm.to` from the Claude/CoWork session environment