@kudawa/pi-contextmap

ContextMap IA para pi: memoria viva del proyecto (brief para agentes, vault de Obsidian y Second Brain) con su servidor MCP listo para usar.

Packages

Package details

extensionskillprompt

Install @kudawa/pi-contextmap from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@kudawa/pi-contextmap
Package
@kudawa/pi-contextmap
Version
1.1.4
Published
Oct 9, 2026
Downloads
1,193/mo · 47/wk
Author
kudawa
License
MIT
Types
extension, skill, prompt
Size
13 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/kudawasama/pi-contextmap/master/assets/preview.png",
  "skills": [
    "./skills/contextmap"
  ],
  "prompts": [
    "./prompts/*.md"
  ],
  "extensions": [
    "./extensions/contextmap-mcp.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@kudawa/pi-contextmap — ContextMap IA para pi

ContextMap IA para pi

Paquete de pi que trae ContextMap IA a tus sesiones: memoria viva del proyecto (brief para agentes + vault de Obsidian), Second Brain con citas y memoria multi-proyecto (lecciones y decisiones de todos tus proyectos).

Instalas el paquete y ya tienes el servidor MCP registrado, una skill con el protocolo y tres comandos listos.

Requisitos

El paquete no incluye el motor: necesita el CLI de ContextMap.

uv tool install "context-map-ai[mcp]"     # recomendado
# o
pip install "context-map-ai[mcp]"

Si falta, la extensión te avisa al iniciar la sesión con el comando exacto.

Instalación

pi install npm:@kudawa/pi-contextmap     # desde npm
pi install ./pi-contextmap               # desde una carpeta local
pi list                                  # verificar

Desde una sesión abierta, ejecuta /reload para que pi lo cargue.

Qué añade

Recurso Nombre Para qué
Extensión contextmap (MCP) Registra el servidor MCP con 30 herramientas y avisa si falta el CLI
Skill /skill:contextmap Protocolo: cómo ponerse en contexto, actualizar sin ensuciar y mantener la memoria viva
Prompt /contextmap-contexto Poner el agente en contexto (brief + pendientes reales)
Prompt /contextmap-cierre Cerrar sesión: refresh, verificar, documentar y resumir
Prompt /contextmap-preguntar Preguntar a la memoria de todos los proyectos, con citas

Herramientas MCP siempre visibles

  • mcp__contextmap__context — leer el brief ejecutivo del proyecto (capa mínima).
  • mcp__contextmap__context_diff — al volver a una sesión: solo lo que cambió desde un digest.
  • mcp__contextmap__personal_panorama — semáforo de todos tus proyectos.
  • mcp__contextmap__personal_query — buscar en lecciones y decisiones.
  • mcp__contextmap__knowledge_wiki_ask — preguntar al Second Brain con citas.

Las 25 restantes (escanear, construir el vault, capturar notas, wiki, repaso espaciado, importadores…) quedan disponibles vía codemode, de modo que no llenan el contexto hasta que se necesitan.

Uso típico

/contextmap-contexto            # al empezar: qué es, en qué estado, qué falta
/contextmap-cierre              # al terminar: actualizar y documentar
/contextmap-preguntar ¿por qué usamos BM25 y no embeddings?

Límites

ContextMap es local-first: sin red en build/refresh, OCR/embeddings/LLM opcionales y apagados por defecto, y tus notas manuales (preserve: true) nunca se borran.

Enlaces

Para mantenedores

Este paquete se publica solo: sube la versión en package.json, crea el tag y empuja. El workflow .github/workflows/publish.yml publica en npm con Trusted Publishing (OIDC) — sin tokens ni códigos (requiere haber autorizado el repo como Trusted Publisher en npmjs.com).

# nueva versión
npm version patch --no-git-tag-version   # o edita package.json
python scripts/make_preview.py           # regenerar la imagen si cambia el texto
git commit -am "chore: vX.Y.Z" && git tag vX.Y.Z && git push --follow-tags

Licencia

MIT