Saltar a contenido

Las páginas sin traducir se abren en inglés y se indican como inglés.

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Preguntas frecuentes

Respuestas breves a las primeras preguntas que suele hacer la gente. Cada una enlaza a la página que la explica.

Uso

¿Cuál es la forma más rápida de probar Loom?

Si ya existe un servidor de Loom, instala el plugin de Claude Code o de Codex y apúntalo al servidor: conectar un agente de código. Para ejecutar un servidor en un portátil, loom up levanta uno en pocos minutos: inicio rápido.

¿Cómo doy memoria a largo plazo a Claude Code, Codex o Cursor?

Usa los plugins de Claude Code o Codex para el contexto y la captura al inicio de sesión, o conecta cualquier otro cliente MCP con loom install --client <name> (consulta clientes MCP). Levanta un servidor con el inicio rápido. Cursor recibe la entrada de MCP y los skills loom y loom-code (sin hooks para el contexto al inicio de sesión; aún no probado en Cursor); la captura de transcripciones proviene del hook independiente sessionEnd. Consulta Conectar un agente de código y Cursor.

¿Por qué mis resultados de búsqueda no tienen sentido?

La instalación ejecuta un embedder falso: su .env (el de un checkout, o ~/.loom/.env) nombra fake-ngram-*, cuyos vectores hacen que la recuperación carezca de sentido. Cambia su embedder, lo que vuelve a calcular los embeddings de lo almacenado (Modelos y claves); una instalación nueva del stack publicado ya usa un modelo local para los embeddings. Un embedder alojado recupera mejor en preguntas con muchas paráfrasis (proveedores).

¿Por qué memory.search responde abstain en lugar de devolver algo?

Ningún resultado superó el umbral de similitud calibrado para tu embedder, así que Loom indica que no lo sabe en lugar de devolver la coincidencia débil más cercana. El motivo aparece en la respuesta. Consulta recuperación y ranking.

¿Por qué mi escritura se marcó como conflicto o se rechazó?

Una escritura de significado cercano a una memoria existente se marca como conflicted y se vincula a ella; una escritura cercana a una memoria fijada se rechaza con 409 PINNED_CONFLICT; una escritura que coincide con un patrón de la lista negra recibe 422 BLACKLISTED. Resuelve los conflictos en la cola de revisión del dashboard o con conflicts.resolve. Consulta conflictos y rechazo.

¿Puedo usar Loom solo para mí?

Sí. Ejecuta el stack local, que no tiene inicio de sesión y tiene un solo espacio de nombres, y conecta tus agentes con el plugin o loom install. En un servidor con inicio de sesión, cada persona recibe un espacio de nombres personal-<slug> en el que sus clientes MCP escriben por defecto y que nadie más lee sin una concesión. La memoria guardada desde Claude Code está entonces disponible para Codex, Cursor y el dashboard.

¿Pueden dos agentes ver las memorias del otro?

Todos los miembros de un espacio de nombres pueden leer sus filas. Cada agente escribe en su propia capa, y un administrador puede copiar una memoria a la capa compartida del espacio de nombres con memory.promote. Un token puede leer varios espacios de nombres mientras escribe en uno. Consulta identidades y espacios de nombres.

¿Cuándo debo usar documentos de conocimiento en lugar de memorias?

Una memoria es una afirmación corta que se puede revisar. Un documento, una página larga o cualquier cosa de más de un par de kilobytes va al plano de conocimiento con knowledge.add, que lo divide en fragmentos y calcula sus embeddings. Consulta memoria y documentos de conocimiento.

¿Cómo hago que Loom olvide algo?

memory.delete marca una memoria con una lápida (restaurable durante un periodo de gracia); erasure.request elimina todo lo que posee un usuario o espacio de nombres, en todas las tablas, y verifica que no quede nada. Loom no borra nada por su cuenta según un calendario, salvo que un operador defina una ventana de retención. Consulta retención y borrado.

¿Cómo averiguo por qué un resultado quedó en esa posición del ranking?

Llama a memory.search con explain=true: el score_components de cada resultado contiene las señales de ranking y, tras un reranker, su movimiento (rerank_from, rerank_pos, rerank_delta) y, cuando el reranker cambió el orden, su propia puntuación fusionada (rank_score_pre_rerank). memory.search_trace puntúa solo la rama vectorial. Consulta búsqueda y ask.

¿Puede Loom responder preguntas sobre mi código?

Sí, para los repositorios que indexa el servidor: code.search, code.symbol, code.callers, code.impact y más, y cada respuesta indica qué commit y qué nivel de índice la respaldan. Consulta el índice de código y añadir un repositorio.

¿Por qué mi agente de código no usa el índice de código?

El plugin adjunta el índice solo cuando la sesión empieza dentro de un checkout de git cuyo remoto es un repositorio indexado que puedes leer. Inicia la sesión desde el checkout del repositorio, comprueba que el repositorio aparece en Repositories en el dashboard (<server>/repositories), y consulta cuándo se usa el índice de código.

Ejecutarlo

¿Necesito ClickHouse Cloud?

No. Loom también funciona con ClickHouse OSS, y el stack para portátil levanta uno en Docker. Cloud es la ruta de producción prevista porque ClickHouse OSS de un solo nodo no tiene replicación ni recuperación a un punto en el tiempo. Consulta el despliegue.

¿Puedo usar modelos de Anthropic o Gemini?

Sí. El proveedor de LLM puede ser OpenAI o Anthropic, y los embeddings pueden venir de OpenAI, Gemini o de un modelo local en CPU. Cambiar el modelo de embeddings cambia el espacio vectorial, así que ejecuta loom reembed después. Consulta LLM y embeddings.

¿Cómo doy acceso a otra persona?

Genera un token (loom mint-token, o en el dashboard, Settings → Tokens) y concede un rol sobre un espacio de nombres. Consulta tokens y permisos.

Algo va mal. ¿Por dónde empiezo?

loom doctor en el servidor, /loom:loom-status en Claude Code y /v1/health. Después, la solución de problemas, que está organizada por síntoma.

El proyecto

¿Por qué falta una operación en mi lista de herramientas MCP?

El listado de MCP depende del toolset (?toolset= o LOOM_MCP_TOOLSET, por defecto core), y las herramientas de código solo se listan con LOOM_MCP_CODE_TOOLS=true. Bajo all, una op que ni el roster core ni el atómico listan y que está marcada como experimental se deja fuera. Aun así, toda op se puede invocar por nombre mediante loom_op (solo lecturas en readonly), por HTTP y desde los SDK. Consulta toolsets de MCP.

¿Qué tan buena es la recuperación y cómo se sabe?

Loom incluye su suite de pruebas de rendimiento con el método, los datasets y los comandos exactos. Solo se indican resultados reproducibles a partir de archivos confirmados en el repositorio. Consulta pruebas de rendimiento.

¿En qué se diferencia Loom de poner una base de datos vectorial junto a mi aplicación?

Con la autoridad ClickHouse por defecto, una sola base de datos ClickHouse contiene las filas, los vectores, el índice de texto, el grafo, la auditoría y el estado de borrado, de modo que no hay nada que mantener sincronizado. La autoridad de memoria en Postgres guarda el estado vivo de la memoria y del conocimiento en Postgres, y Loom mantiene por sí mismo la coherencia entre ambos almacenes. Cada escritura se comprueba contra lo almacenado. La descripción general enumera lo que cuesta cada propiedad y cuándo Loom no encaja.