engram – Sistema de Memória Personal com Obsidian e Claude
chardila/engram
Vault inteligente: Obsidian + skills Claude para memória pessoal estruturada
Ver no GitHubSistema integrado que conecta um vault Obsidian com skills do Claude para criar um registro estruturado de pensamento, decisões e aprendizados. Automatiza rotinas diárias (preparação do dia, fechamento, processamento de inbox) e oferece análises periódicas do vault para identificar padrões, projetos órfãos e oportunidades de melhoria.
Instalação
npx convez-ai chardila/engram1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Preparação diária automatizada com leitura de estado e definição de prioridades
- Processamento de inbox e conversão de loops abertos em tarefas estruturadas
- Análise e auditoria mensal de padrões, projetos descuidados e sinais fracos
- Ingestão de URLs com extração automática de conceitos e atualização de cross-links
Veredito

Solução robusta e bem documentada para quem busca um sistema de segunda cérebro integrado ao Claude. Requer configuração manual do MCP (Obsidian REST API) e bom domínio de shell/git, mas oferece automação real de rotinas cognitivas e rastreamento estruturado de conhecimento pessoal.
README
A tradução para o português deste README ainda está na fila.
engram
Sistema de memoria personal: vault de Obsidian + skills para Claude Code.
engram = la huella física que un recuerdo deja en el cerebro. Lo que Claude escribe en el vault no es un log de actividad — es el registro de cómo se piensa y se decide.
Qué incluye
.claude-plugin/— manifiesto del plugin para Claude Code (plugin.json)skills/— skills de Claude Code (fuente de verdad)vault-template/— estructura del vault con plantillassetup.sh— instala todo desde cero en una máquina nueva
Instalación rápida
git clone https://github.com/<tu-usuario>/engram.git
cd engram
./setup.sh <tu-usuario-github> brain-personal ~/vault/brain-personal
El script hace todo automáticamente:
- Instala el plugin engram en Claude Code (
~/.claude/skills/engram/) - Instala Obsidian (snap en Linux, Homebrew en Mac)
- Crea el vault desde
vault-template/o clona uno existente - Descarga los 8 plugins de comunidad de Obsidian (incluido Local REST API with MCP)
- Registra el vault en Obsidian (visible al abrir la app)
- Registra el MCP en Claude Code si el plugin ya fue inicializado, o imprime las instrucciones si no
Configuración MCP
El MCP usa el plugin Local REST API with MCP (obsidian-local-rest-api v4.1.3 por Adam Coddington). Es el MCP recomendado para Obsidian: acceso nativo al vault con soporte de búsqueda, metadata y frontmatter.
Primera vez (paso manual obligatorio):
- Abre Obsidian →
Settings → Community plugins → habilita "Local REST API with MCP" - En la configuración del plugin: activa "Enable Non-encrypted (insecure) Server" (puerto 27123)
- El servidor HTTPS (puerto 27124) genera un certificado autofirmado que Claude Code no acepta
- Copia el API Key que muestra el plugin
- Registra el MCP en Claude Code:
claude mcp add brain-personal -s user \
--type http \
--header "Authorization: Bearer <API_KEY>" \
"http://127.0.0.1:27123/mcp"
Si re-ejecutas setup.sh después de que el plugin fue inicializado, el paso 4 se hace automáticamente.
Requisito: Obsidian debe estar abierto para que el MCP responda.
Skills disponibles
| Comando | Propósito |
|---|---|
/daily-prep | Inicio del día: lee STATE.md, crea nota diaria, propone prioridades |
/end-day | Cierre: captura aprendizajes, actualiza AI/sessions/, regenera STATE.md |
/process-inbox | Convierte loops abiertos en notas y tareas estructuradas |
/review-week | Journal semanal + STATE.md con vista de la semana completa |
/analyze-vault | Auditoría mensual: proyectos huérfanos, áreas descuidadas, señales débiles |
/review-system | Meta-revisión mensual: patrones de uso, fricciones, mejoras al sistema |
/ingest-url <url> | Ingesta una URL: crea nota en Sources/, extrae conceptos a Resources/, actualiza MOCs y cross-links |
/publish-post <búsqueda> | Publica una nota del vault como post en el blog: adapta contenido, genera imagen de portada, escribe draft en el repositorio del blog |
Uso típico
"ejecuta /daily-prep"
"Añade a loops abiertos: revisar artículo de arquitectura hexagonal"
"ejecuta /process-inbox"
"ejecuta /end-day"
Estructura del vault
tu-vault/
├── CLAUDE.md ← instrucciones para Claude (completar al instalar)
├── STATE.md ← estado actual: generado por Claude, aprobado por ti
├── Context/ ← quién eres: metas, valores, preferencias
├── Skills/ ← copias de skills/ del repo (referencia en Obsidian)
├── Inbox/ ← nota diaria + capturas rápidas
├── Projects/dev/ ← proyectos activos (con links a PRs/commits)
├── Areas/ ← responsabilidades continuas
├── Resources/concepts/ ← notas atómicas de conceptos
├── Resources/moc-*.md ← mapas de contenido por tema
├── Archive/ ← proyectos completados
├── AI/sessions/ ← logs de sesión
├── Templates/ ← plantillas
└── Journal/ ← revisiones semanales/mensuales
Tres convenciones no delegables a Claude
author:en frontmatter de cada archivo desde el día uno (useroclaude)## Cierreescrito por ti antes de archivar cualquier proyecto## Hechos durosen STATE.md es solo de edición manual — ancla lo que Claude no puede inferir
Actualizar los skills
Re-ejecuta setup.sh desde el repo actualizado:
cd engram
git pull
./setup.sh <tu-usuario-github> brain-personal ~/vault/brain-personal
El script sobreescribe ~/.claude/skills/engram/ con los skills actualizados.
Repos relacionados
engram(este repo) — plugin + template, públicobrain-personal— vault personal, privado