local-rag-wiki

Una wiki RAG local del repositorio para agentes de IA: un servicio de conocimiento MCP por repositorio (búsqueda / lectura / escritura gobernadas de notas wiki en Markdown) más un instalador que lo integra en las herramientas de tu agente. Se requiere Docker para ejecutar el servicio.

Inicio rápido (recomendado)

Descarga previamente la imagen del servicio antes de tu primera sesión de agente para evitar retrasos de arranque en frío:

docker pull ihorleleka/project-rag-wiki:latest

Related MCP server: hw_rag_mcp

Instalación

Ejecuta en la raíz de tu repositorio:

npx github:ihorleleka/Local-Rag-Wiki install .

Esto genera el runner gestionado .agents/, la sección de política AGENTS.md, la configuración MCP para DeepSeek Harness (.dsh/mcp.servers.yml), Claude Code, Codex, VS Code y OpenCode, además de una carpeta wiki/. Estas integraciones son aditivas: instalar el soporte de DSH no elimina ni reemplaza las otras configuraciones de harness. El servicio MCP se inicia entonces automáticamente por repositorio cuando tu cliente de agente se conecta. Se recomienda descargar previamente la imagen (arriba) antes de ejecutar el agente en un entorno nuevo.

DeepSeek Harness

Instala el bundle nativo de DSH una vez en el perfil que uses (normalmente web):

dsh plugin --profile web add github:ihorleleka/Local-Rag-Wiki

Reinicia ese perfil de DSH, abre un repositorio instalado como su espacio de trabajo e inicia una sesión. En agent/created, el bundle usa el espacio de trabajo real del agente (incluido un --agents-dir personalizado) para montar el @deepseek-ai/dsh-mcp-client oficial de DSH, lanzar el runner MCP gestionado, reconectarlo, descubrir sus herramientas y registrar herramientas mcp__wiki-manager__* predecibles. El cliente permanece con ámbito de agente aunque el espacio de nombres sea estable. El runner inicia o se conecta al servicio Docker de ese repositorio exactamente igual que hace con los otros harness.

También monta un coordinador de recuerdo de Cordis controlado por marcador para ese espacio de trabajo: agent/session-start siembra pistas de temas recurrentes; agent/pre-step usa el estado local y luego realiza una recuperación wiki acotada solo para un prompt sustancial—primero wiki_search depth="abstract" (L0) y después el contexto depth="packet" correspondiente (L1). Etiqueta la evidencia y deja al modelo las decisiones completas de L2 wiki_read. session/event registra un resumen del asistente, mientras que agent/turn-stopping y session/flush recortan y persisten el estado. El recuerdo se almacena en caché por espacio de trabajo y se deduplica en vuelo; los paquetes L1 tienen límite de tasa, los arranques en frío disponen de una asignación acotada de 90 segundos y las actualizaciones de estado se ponen en cola con reemplazo atómico. No se usa ningún estado ni proceso wiki fuera de un repositorio con un marcador de instalación de wiki-kit.

El .dsh/mcp.servers.yml generado sigue siendo una alternativa de configuración de espacio de trabajo; prefiere el bundle de perfil en lugar de ejecutar ambos puentes, lo que crearía dos conexiones MCP al mismo servicio de repositorio. AGENTS.md sigue siendo la capa de política portable.

Los hooks de .agents/hooks/ y .claude/settings.local.json son específicos de Claude Code. La interceptación del ciclo de vida de DSH corresponde a los plugins Cordis de Host/Perfil de confianza, no a un manifiesto de hooks local al proyecto. Consulta .dsh/README.md para conocer el límite de la configuración de espacio de trabajo.

Actualización

Después de la instalación, actualiza los archivos gestionados desde dentro del repositorio — no se necesita npx:

.agents\update-wiki-kit.cmd --force

sh .agents/update-wiki-kit.sh --force

Ciclo de vida

npx github:ihorleleka/Local-Rag-Wiki status .
npx github:ihorleleka/Local-Rag-Wiki restart .
npx github:ihorleleka/Local-Rag-Wiki doctor . --live

start ., stop . y pull . están disponibles de la misma manera. El