save / save-session / observe
Los comandos de escritura proponen memorias a través del control de aprobación.
save
engram save [rule|workflow|knowledge] "<text>"
engram save --role frontend "<text>"
engram save --scope global "<text>"
engram save captura el mejor candidato de memoria única, actualiza automáticamente una memoria coincidente o crea una nueva, y siempre muestra la puerta de aprobación A/B/C antes de escribir.
Cuando engram save encuentra memorias activas relacionadas, la vista previa de aprobación las informa con una sugerencia de depends_on o una advertencia de posible duplicado.
save-session
engram save-session
engram ss
engram save-session --query-level 3
engram ss -a
engram ss -a last 50 sessions
engram save-session --file transcript.md
engram save-session --accept-all
Usa save-session cuando una interacción larga produzca varios candidatos:
TYPE: rule | TEXT: Always run tests before release. | CONTEXT: Created from release planning so future agents preserve the test gate.
TYPE: knowledge | TEXT: Release notes live in CHANGELOG.md.
TYPE: workflow | TEXT: When releasing, run tests, update changelog, then tag.
CONTEXT: ... es opcional. Agrégalo solo cuando explique por qué existe la memoria. Los candidatos también pueden agregar campos DEPENDS_ON, LEVEL o UPDATE al reestructurar memorias relacionadas.
--query-level <n>— extrae hasta n chats recientes accesibles entre humano y agente; debe ser un entero positivo; los agentes no deben inventar historial no disponible--accept-all/-a— se guarda cada candidato generado porque el humano aprobó explícitamente ese acceso directo--file <path>— para transcripciones o resúmenes largos ya en el disco
Para /engram take-control --accept-all o el /engram take control accept all natural, el adaptador normaliza la redacción, genera solo candidatos concisos TYPE: ... | TEXT: ... y permite que Engram los guarde sin una segunda solicitud de aprobación.
observe
engram observe --file session.md
engram save-session --file .agents/.engram/inbox/<note>.md
observe almacena notas sin procesar e higienizadas en inbox/. Las notas de la bandeja de entrada no son memoria activa. Usa esto cuando desees preservar notas preliminares antes de decidir qué debería convertirse en memoria duradera.
Pistas de memoria relacionada
Cuando una ejecución de aceptar todo informa memorias relacionadas antes de escribir, no se guardó ningún archivo aún. El agente debe volver a ejecutar con candidatos estructurados:
TYPE: rule | TEXT: OAuth rotation follows release foundations. | DEPENDS_ON: release-foundation | LEVEL: advanced
TYPE: knowledge | TEXT: Invoice retries use exponential backoff. | UPDATE: invoice-retry-baseline