En Omarchy, en el panel
Si usas Omarchy, Lemoria instala lemoria.usage: total en la barra, hoy, 7 días, presupuesto mensual y tabla por agente con modelo dominante.
_ _____ __ __ ___ ____ ___ _ | | | ____| \/ |/ _ \| _ \|_ _| / \ | | | _| | |\/| | | | | |_) || | / _ \ | |___| |___| | | | |_| | _ < | | / ___ \ |_____|_____|_| |_|\___/|_| \_\___/_/ \_\
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.
$ lemoria features --allCada decisión, cada línea de código, cada conversación — todo queda registrado y trazable.
Flujo completo: discovery → spec → PRD → tasks → architecture → implementation → testing → review → commit → push → documentation → memory.
Cada task tiene un ID único. Commits con task-XXX. Todo conectado al PRD original.
Orquestador + implementation + frontend + DB + testing + GitHub + review + documentation. Cada uno con contexto limitado.
Todo se persiste en PostgreSQL 16 con SQLAlchemy. La base de datos es el único fuente de verdad.
Commits con formato tipo(scope): descripción [task-XXX]. Trazabilidad automática código ↔ requerimientos.
Cada decisión técnica se registra con contexto, opciones consideradas y justificación.
Cada paso del flujo se persiste en flow_steps. Si el contexto del LLM se pierde, se retoma desde donde quedó.
Exporta DB a markdown con wikilinks y restaura DB desde notas. Sin pérdida de datos.
8 enums tipados con restricciones a nivel DB. Sin strings mágicos.
Suite con pytest en SQLite in-memory + CI en GitHub Actions con matrix Python 3.11/3.12/3.13.
Skills especializadas: frontend, backend, database, testing, code-review, git-workflow, documentation.
Documentación en tiempo real de librerías y frameworks vía MCP server.
Lee opencode.db en modo read-only: sesiones, tokens y costo por agente. lemoria usage te da el total histórico, el desglose por modelo y por subagente.
Instala un plugin propio de Omarchy: total histórico siempre visible, presupuesto mensual y tabla por agente con modelo. No toca /usr/share/omarchy.
Fija modelo y reasoning effort por subagente. Por defecto heredan el de quien los invoca, y se cambian cuando quieras.
$ lemoria agents --listCada agente tiene un rol específico, permisos ajustados y recibe solo el contexto que necesita.
Analiza el contexto, aplica SDD, delega tareas a subagentes y consolida resultados.
Implementa lógica de backend, scripts, APIs y toda la lógica de negocio.
Implementa interfaces de usuario, componentes, estilos y routing.
Diseña esquemas, genera migraciones, optimiza consultas y asegura integridad referencial.
Escribe tests unitarios y de integración con pytest. Verifica cobertura.
Mantiene trazabilidad con GitHub: issues, PRs, milestones. Solo lectura.
Revisa código, arquitectura y decisiones técnicas. Solo observa y reporta.
Genera y mantiene documentación en Obsidian vault, READMEs y markdown.
$ lemoria flow --help15 pasos desde la idea hasta la memoria actualizada. Cada paso queda registrado en PostgreSQL.
$ lemoria usage --jsonLemoria lee opencode.db en modo read-only y convierte el consumo disperso en una sola lectura: cuánto llevas, en qué modelos y qué agente lo gastó.
Si usas Omarchy, Lemoria instala lemoria.usage: total en la barra, hoy, 7 días, presupuesto mensual y tabla por agente con modelo dominante.
El panel nativo de Omarchy no tiene esos campos. El plugin propio lee las claves extras del mismo record; quienes no usan Omarchy siguen teniendo el CLI.
Conexión read-only y cada agregado pushed a SQL. Lemoria lee miles de sesiones sin dejar un archivo de bloqueo ni frenar una sesión en curso.
$ ./install.shClona, corre el instalador y abre OpenCode. El script resuelve la base de datos y el paquete de Python por vos.
git clone https://github.com/devcristianlopez/lemoria.git
./install.sh — revisa tu máquina, resuelve PostgreSQL e instala el paquete con uv → venv → pip.
lemoria project create "Mi proyecto" — después abrí OpenCode y delegá con @orchestrator.
$ ./install.sh [1/9] Verificando requisitosEl instalador no adivina: mira tu máquina y elige el camino más limpio que funcione. Esto es lo que decide.
Tiene que responder algo en localhost:5432. Si tu servidor ya está corriendo, el instalador lo respeta y no lo toca: solo verifica que las credenciales de .env sirvan.
Debian/Ubuntu: sudo apt install postgresql · Fedora: sudo dnf install postgresql · macOS: brew install postgresql
sudo usermod -aG docker $USER:
el grupo docker equivale a root sin contraseña. Tener acceso al socket del daemon permite montar /, editar /etc/shadow y correr contenedores privilegiados. Lemoria no lo recomienda: usá la vía A, que no pide ese privilegio.
Se prueban en orden y cada uno es más invasivo que el anterior. Solo se cae al siguiente si el anterior falló.
uv → venv → pip
Fuera de Arch, uv no está en los repos: se instala desde su propia documentación. No pide sudo ni toca el intérprete del sistema.
pip install -e . falla en Arch + Python 3.14:
Arch separa pip del intérprete — python3 -m pip responde No module named pip — y PEP 668 marca el intérprete del sistema como EXTERNALLY-MANAGED. Romper eso con --break-system-packages desactiva la protección y puede arrastrar a otras herramientas.