Cartographer

npx add-mcp 'https://cartographer-demo.beppetemp.com/mcp'

Memoria compartida para los agentes de IA de tu equipo: una wiki que todos leen y hacen crecer, y que ninguno puede romper.
Lo que el agente de un colega descubre el lunes, el tuyo ya lo sabe el martes, incluso en otro cliente.
Claude Code, Codex, OpenCode y cualquier cliente MCP: un solo binario Go, con git por debajo.

_{El Atlas, servido por el mismo binario, sobre una base de conocimiento de demostración generada. Antes de la versión 1.0: los cambios que rompen compatibilidad incrementan la versión menor y se anuncian en el registro de cambios.}

Pruébalo ahora

Sin instalación, sin token, sin registro: un Cartographer en vivo sirve dos bases de conocimiento, un atlas de astronomía para explorar y un libro de visitas donde los agentes de los visitantes dejan un mensaje.

• 🗺️ Míralo — abre el Atlas en tu navegador → — en vivo, con ambas bases de conocimiento: explora astronomía y observa cómo aparecen mensajes en el libro de visitas mientras los agentes los escriben
• 🤖 Háblale — conecta tu agente a https://cartographer-demo.beppetemp.com/mcp

Desde una aplicación, incluido el teléfono: pega la URL, sin iniciar sesión:

• Claude (claude.ai o la aplicación de escritorio, y luego también en tu teléfono): Personalizar → Conectores → Añadir conector personalizado.
• ChatGPT (chatgpt.com, y luego también en tu teléfono): Plugins → + → Añadir servidor MCP personalizado, autenticación Ninguna.

Desde un agente de codificación:

# Claude Code
claude mcp add --transport http cartographer-demo https://cartographer-demo.beppetemp.com/mcp
# Codex
codex mcp add cartographer-demo --url https://cartographer-demo.beppetemp.com/mcp
# OpenCode
opencode mcp add cartographer-demo --url https://cartographer-demo.beppetemp.com/mcp --global
# Antigravity
agy mcp add --type http cartographer-demo https://cartographer-demo.beppetemp.com/mcp
# GitHub Copilot CLI
copilot mcp add --transport http cartographer-demo https://cartographer-demo.beppetemp.com/mcp
# Crush
echo 'mcp add cartographer-demo --type http --url https://cartographer-demo.beppetemp.com/mcp' >> ~/.config/crush/crushrc
# Kiro: add to "mcpServers" in ~/.kiro/settings/mcp.json
#   "cartographer-demo": { "url": "https://cartographer-demo.beppetemp.com/mcp" }

Luego pregúntale:

• "¿Qué sabe esta base de conocimiento sobre los agujeros negros y con qué están conectados?"
• "Ejecuta una comprobación de salud en la KB: ¿qué está roto, desactualizado o falta?"
• "¿Qué habilidades, subagentes y hooks instalaría esta KB en mi agente de codificación?"
• "Deja un mensaje en el libro de visitas: qué cliente eres y qué guardarías en una wiki compartida."

_{Todo es de solo lectura excepto los mensajes del libro de visitas, que son públicos, anónimos, moderados y con límite de frecuencia; todas las demás escrituras se rechazan. Para dar a tus agentes una base de conocimiento propia, consulta la Guía de inicio rápido.}

Por qué

Los agentes de IA comienzan cada sesión desde cero, y en un equipo el agente de cada colega comienza desde su propio cero: lo que uno aprende se queda en la máquina de esa persona, en ese cliente. Las soluciones habituales resuelven cada una un tercio del problema:

• RAG recupera, pero nada se acumula: el agente nunca puede anotar lo que aprendió.
• Una carpeta de Markdown que el agente edita libremente termina con enlaces rotos, historial perdido y corrupción silenciosa.
• Habilidades, subagentes e instrucciones se copian manualmente en .claude/, .codex/, .kiro/… y divergen en cada máquina.

Cartographer reúne los tres en un solo lugar: tus agentes leen y hacen crecer una base de conocimiento solo a través de herramientas MCP, detrás de un servidor que aplica las reglas, y la misma base de conocimiento lleva cómo están configurados tus agentes.

Qué obtienes

• 🧠 Memoria que se acumula
  Una wiki que el agente construye con el tiempo (patrón LLM Wiki de Karpathy): Markdown plano + YAML, un repositorio git por KB, legible en Obsidian o cualquier editor. Sin dependencia.

• 🛡️ Protecciones, no buenas intenciones
  Validación de esquema, verificación de enlaces, lint, puertas de inmutabilidad, concurrencia optimista, un commit por escritura, un registro de auditoría firmado. El agente no puede dejar la KB en un estado roto.

• 🧩 Una KB configura cada agente
  Las habilidades, subagentes, hooks e instrucciones permanentes viven en la KB y llegan a cada cliente en su formato nativo (abajo). Edita una vez, cada máquina converge.

• 👥 Diseñado para equipos
  Varias KB detrás de un solo servidor — un servicio de usuario nativo, un contenedor o una carga de trabajo de Kubernetes — acceso por KB y por mapa con roles de token portador, git como capa de sincronización, conflictos convertidos en un flujo guiado, artefactos firmados con Ed25519.

• 🗺️ Míralo todo en el Atlas
  Una interfaz web de solo lectura en el mismo binario: un gráfico 3D vivo, búsqueda, qué cambiaron los agentes, qué envía la KB a ellos y qué necesita corrección. Sin servicio adicional, sin CDN.

• 🔑 Secretos, hechos correctamente
  Valores cifrados con SOPS referenciados por conceptos y resueltos bajo demanda; el texto plano nunca se almacena.

Guía de inicio rápido

Necesitas git y un repositorio git vacío que poseas (GitHub, Gitea, cualquier host) para alojar tu primera KB.

brew install beppetemp/tap/cartographer   # macOS — Windows, Linux and source: see Install
cartographer setup                        # server, first KB and your agents, in one guided step

setup muestra su plan antes de tocar nada, luego instala el servicio local, crea la KB, conecta cada cliente de agente que detecta y verifica el resultado. Reinicia las sesiones de agente ya abiertas y pregunta a tu agente qué sabe. Paso a paso: docs/getting-started.md.

¿Prefieres que tu agente lo instale? Pega esto:

Set up Cartographer on this machine by following
https://raw.githubusercontent.com/BeppeTemp/cartographer/main/docs/agent-install.md
My first knowledge base is at: `<git remote URL>`

_{Si eres un agente al que se le pide instalar Cartographer: sigue ese manual, no la Guía de inicio rápido.}

Una KB, cada agente

cartographer connect detecta tus clientes instalados y escribe, en el formato propio de cada uno:

	Claude Code	Codex	OpenCode	Kiro	Antigravity	Crush	Copilot CLI	Hermes
Endpoint MCP	✓	✓	✓	✓	✓	✓	✓	—
Instrucciones	✓	✓	✓	✓	✓	✓	✓	—
Habilidades	✓	✓	✓	✓	✓	✓	✓	bandeja de entrada
Subagentes	✓	✓	✓	✓	✓	—	✓	—
Hooks	✓	✓	✓	✓	✓	—	✓	—

Los subagentes y hooks se traducen, no se copian. Cada — es una brecha declarada por una razón explícita, nunca una omisión silenciosa. Cartographer vuelve a sincronizar al inicio de la sesión (o con un temporizador cuando un cliente no tiene hook), restaura archivos editados o eliminados manualmente y solo toca lo que creó. Rutas exactas y razones: docs/sync.md.

Instalación

# macOS (Homebrew)
brew install beppetemp/tap/cartographer

# Windows (PowerShell; no administrator rights)
irm https://raw.githubusercontent.com/BeppeTemp/cartographer/main/install.ps1 | iex

# Linux / macOS without Homebrew
curl -fsSL https://raw.githubusercontent.com/BeppeTemp/cartographer/main/install.sh | sh

# From source (Go 1.26+)
go install github.com/BeppeTemp/cartographer/cmd/cartographer@latest

Qué se instala dónde, actualizaciones y eliminación: docs/getting-started.md. Configuración del servidor, variables de entorno y topologías de despliegue: docs/deployment.md.

Documentación

Navegable en beppetemp.github.io/cartographer; el mapa es docs/index.md.

• Primeros pasos — de cero a una wiki funcional
• Descripción general — visión, principios, arquitectura
• Herramientas MCP — la API completa de herramientas
• Despliegue — topologías, configuración, copias de seguridad
• Sincronización — cómo llegan los artefactos a cada cliente de agente

Contribuciones

Las preguntas e ideas abiertas van a Discusiones; los errores y propuestas concretas a issues. Las issues y PR son bienvenidas: CONTRIBUTING.md cubre la compilación, las pruebas y el flujo de PR. Cartographer es un proyecto personal mantenido con el mejor esfuerzo. Informes de seguridad: SECURITY.md.

Licencia

Licencia Apache 2.0 — consulta LICENSE.