project@lemoria:~$ cat README.md | head -5
 _     _____ __  __  ___  ____  ___    _    
| |   | ____|  \/  |/ _ \|  _ \|_ _|  / \   
| |   |  _| | |\/| | | | | |_) || |  / _ \  
| |___| |___| |  | | |_| |  _ < | | / ___ \ 
|_____|_____|_|  |_|\___/|_| \_\___/_/   \_\

Memory OS para tu desarrollo con IA

Orquesta proyectos de software con trazabilidad total usando Spec Driven Development, 8 agentes OpenCode y PostgreSQL como fuente de verdad. Desde la idea hasta el commit y la documentación.

8
Agentes
13
Pasos SDD
234
Tests
7
Skills
$ lemoria features --all

Características

Cada decisión, cada línea de código, cada conversación — todo queda registrado y trazable.

[01]

Spec Driven Development

Flujo completo: discovery → spec → PRD → tasks → architecture → implementation → testing → review → commit → push → documentation → memory.

[02]

Trazabilidad total

Cada tarea tiene un ID único y cada commit queda enlazado con Task: <uuid>. Todo vuelve al PRD original.

[03]

8 Agentes OpenCode

Orquestador + implementation + frontend + DB + testing + GitHub + review + documentation. Cada uno con contexto limitado.

[04]

PostgreSQL fuente de verdad

Todo se persiste en PostgreSQL 16 con SQLAlchemy. La base de datos es la única fuente de verdad.

[05]

Conventional Commits

Commits convencionales con trailer Task: <uuid>. Trazabilidad automática código ↔ requerimientos.

[06]

Architecture Decision Records

Cada decisión técnica se registra con contexto, opciones consideradas y justificación.

[07]

State Machine Resumible

Si una sesión se corta o el contexto se pierde, el flujo queda guardado y puede retomarse sin partir de cero.

[08]

Vault Bidireccional

Exporta DB a markdown con wikilinks y restaura DB desde notas. Sin pérdida de datos.

[09]

Datos consistentes

Estados y relaciones validados en la base de datos para evitar registros ambiguos o rotos.

[10]

234 Tests + CI Automático

Suite con pytest en SQLite in-memory + CI en GitHub Actions con matrix Python 3.11/3.12/3.13.

[11]

7 Skills Modulares

Skills especializadas: frontend, backend, database, testing, code-review, git-workflow, documentation.

[12]

Context7 MCP

Documentación en tiempo real de librerías y frameworks vía MCP server.

[13]

Telemetría de opencode

Resume sesiones, tokens y costo por agente sin bloquear OpenCode. lemoria usage muestra total histórico, modelos y subagentes.

[14]

Panel de Omarchy

Instala un plugin propio de Omarchy: total histórico siempre visible, presupuesto mensual y tabla por agente con modelo. No toca /usr/share/omarchy.

[15]

Modelos por agente

Fija modelo y esfuerzo por agente desde CLI o desde el menú Ctrl+P de OpenCode. Sin editar archivos a mano.

$ lemoria agents --list

Los 8 agentes

Cada agente tiene un rol específico, permisos ajustados y recibe solo el contexto que necesita.

orchestrator

Orquestador

Orquestador

Analiza el contexto, aplica SDD, delega tareas a subagentes y consolida resultados.

implementation-agent

Implementation

Implementación

Implementa lógica de backend, scripts, APIs y toda la lógica de negocio.

frontend-agent

Frontend

UI / UX

Implementa interfaces de usuario, componentes, estilos y routing.

db-agent

Database

Base de datos

Diseña esquemas, genera migraciones, optimiza consultas y asegura integridad referencial.

testing-agent

Testing

Pruebas

Escribe tests unitarios y de integración con pytest. Verifica cobertura.

github-agent

GitHub

Trazabilidad

Mantiene trazabilidad con GitHub: commits, pushes, PRs e issues conectados al trabajo.

review-agent

Review

Revisión técnica

Revisa código, arquitectura y decisiones técnicas. Solo observa y reporta.

documentation-agent

Documentación

Documentación

Genera y mantiene documentación en Obsidian vault, READMEs y markdown.

$ lemoria flow --help

Spec Driven Development

Flujo completo desde la idea hasta la memoria actualizada. Cada etapa queda registrada y se puede auditar.

1DiscoveryPreguntas esenciales
2SpecEspecificación detallada
3PRDProduct Requirements
4TasksDesglose en tareas
5ArchitectureDiseño arquitectónico
6ImplementationCódigo por agentes
7TestingTests unitarios + integración
8ReviewRevisión técnica
9CommitConventional Commit
10PushSubida a GitHub
11DocumentationDocumentación generada
12Memory UpdateActualizar memoria
13State MachineEstado persistente
$ lemoria usage --json

Tu consumo, de verdad

Lemoria consolida sesiones, tokens y costo en una sola lectura: cuánto llevas, qué modelos usaste y qué agente generó el consumo.

user@host — lemoria usage
$lemoria usage
Total 273.8M tokens (2026-08-17 → 2026-09-28)
  101 sessions · 4187 prompts · 11 active days
By model (all-time)
opencode/big-pickle 232.8M in 9.5M · out 220.8M · cache 2.6M
nvidia/…nemotron-3.5-lightning 40.8M in 2.0M · out 38.6M
By agent (all-time)
orchestrator 160.3M 8 sessions
build 46.2M 5 sessions
implementation-agent 35.7M 36 sessions
$ ./install.sh

Listo en 3 pasos

Clona, corre el instalador y abre OpenCode. El detalle fino vive en INSTALL.md; la landing va al grano.

project@lemoria — ~/lemoria
$git clone https://github.com/devcristianlopez/lemoria.git
$cd lemoria
$./install.sh
→ uv uv 0.12.1 (primario)
→ postgres localhost:5432 (ya respondía — no se tocó)
✓ Lemoria instalado vía: uv
$lemoria project create "Mi proyecto" -d "Descripción"
$lemoria flow start <project-id> "Mi idea"
$opencode .