yoshi/second-brain-skill
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases 1 Packages Wiki Activity Actions
Claude Code Plugin: Second Brain Vault Integration
60 commits 5 branches 2 tags 206 KiB
  • TypeScript 55.5%
  • Shell 44.5%
Find a file
Exact
Yoshi 5af9733d93 Merge branch 'feat/opencode-adapter' — OpenCode-Adapter v2.3.0
2026-05-07 14:13:00 +02:00
.claude-plugin chore: Versionsbump 2.2.0 → 2.3.0 (OpenCode-Adapter) 2026-05-07 14:10:11 +02:00
.codex-plugin chore: Versionsbump 2.2.0 → 2.3.0 (OpenCode-Adapter) 2026-05-07 14:10:11 +02:00
.opencode-commands feat(opencode): Slash-Commands brain-{compile,status,hygiene,init} 2026-05-07 14:09:01 +02:00
.opencode-plugin feat(opencode): Plugin-Hooks (capture, flush, status-injection) 2026-05-07 14:05:43 +02:00
commands feat: Codex-Slash-Commands und interface-Block 2026-05-07 11:02:46 +02:00
docs/superpowers docs: plan-checkboxen auf erledigt setzen 2026-04-08 20:17:38 +02:00
hooks feat(hooks): dual-shape JSON-Output in session-start 2026-05-07 09:15:52 +02:00
skills fix(brain:compile): kollisionssichere Move-Logik (fail-loud) 2026-05-07 11:17:13 +02:00
.gitignore chore: .worktrees/ in gitignore 2026-04-07 19:42:05 +02:00
BACKLOG.md fix(brain:compile): kollisionssichere Move-Logik (fail-loud) 2026-05-07 11:17:13 +02:00
LICENSE init: Plugin-Scaffolding mit Metadaten, README und Design-Docs 2026-04-06 21:08:36 +02:00
README.md chore: Versionsbump 2.2.0 → 2.3.0 (OpenCode-Adapter) 2026-05-07 14:10:11 +02:00

README.md

Second Brain — Knowledge Brain Plugin

Karpathy-Pattern Wiki mit automatischer Erfassung und LLM-Compile. Ersetzt manuelles Wissensmanagement durch Hooks + Compile-Schritt.

Was es tut

  1. Automatisch: Hooks erfassen Tool-Aktivitaet waehrend jeder Session
  2. Bei Session-Ende: Buffer wird nach raw/<projekt>/ geschrieben
  3. Bei Session-Start: LLM kompiliert unkompilierte raw/-Dateien ins Wiki

Commands

Command Zweck
/brain:compile Manueller Compile — alle raw/ aufs Mal
/brain:init Vault-Setup auf neuem Rechner
/brain:hygiene Strukturpruefung
/brain:status Quick-Check: raw/, Compile, Hygiene

Hooks (automatisch)

Hook Zweck
PostToolUse Tool-Metadaten in Buffer erfassen
Stop Buffer nach raw/ verschieben + Zusammenfassung anfordern (Block-Decision, Anti-Loop nach 10 Min oder bei <5 Tool-Calls)
SessionStart Catch-Up + Auto-Compile + Vault-Kontext

Setup

# 1. Vault clonen (falls noch nicht vorhanden)
git clone git@git.waldegg.li:yoshi/second-brain.git ~/Development/second-brain

# 2. Plugin ist ueber waldegg-marketplace installiert

Codex

Dieses Plugin funktioniert auch in Codex. Skills werden ueber Description gematcht (es gibt keine Slash-Commands wie in Claude). Tippe in Codex „kompiliere mein Brain“ / „pruef die Vault-Hygiene“ / „Vault initialisieren“, und der passende Skill greift. Den SessionStart-Hook erlebst du wie in Claude: beim Sessionstart erscheint Brain-Status + ggf. Catch-Up im Kontext.

Installation siehe waldegg-marketplace/docs/install-codex.md.

Projekt-Konfiguration

Jedes Projekt braucht .second-brain/config.md:

---
vault: ~/Development/second-brain
remote: git@git.waldegg.li:yoshi/second-brain.git
---

Und .second-brain/ in .gitignore.

Architektur

Session → PostToolUse → Buffer → Stop → raw/<projekt>/
                                          ↓
                              SessionStart → Compile → Wiki

OpenCode

Der OpenCode-Adapter besteht aus einem TS-Plugin (.opencode-plugin/) und vier Slash-Commands (.opencode-commands/). Installation ueber Symlinks — Details in der Marketplace-Doku (docs/install-opencode.md im claude-marketplace-Repo).

Beim Sessionende flusht das Plugin den Buffer nach <vault>/raw/<projekt>/<datum>.md. Buffer-Pfad: ~/.second-brain-buffer-opencode (eigener Pfad, damit OpenCode/Claude/Codex sich nicht in die Quere kommen).