Pathrule para VS Code

Pathrule para VS Code es una superficie nativa del editor. Lleva al editor el árbol de conocimiento del espacio de trabajo, la edición de contenido y la configuración de clientes de IA, de modo que la carpeta que tienes abierta es el espacio de trabajo y el archivo que estás editando es la ruta. Es la superficie adecuada si trabajas todo el día en VS Code, Cursor o Windsurf y quieres tener tu conocimiento junto a tu código.

Es una superficie de editor enfocada. El mismo contenido y los mismos hooks con los que trabaja la CLI se manejan desde el editor que ya usas, y la configuración de clientes externos reutiliza el instalador de la CLI.

Instalación

Instálala desde Visual Studio Marketplace, o desde Open VSX para que Cursor y Windsurf también puedan instalarla. Desde una terminal:

code --install-extension Pathrule.pathrule-vscode

O bien, desde el editor, abre el prompt de Quick Open y ejecuta:

ext install Pathrule.pathrule-vscode

Es gratuita y de código abierto bajo Apache-2.0, y el modo local no requiere cuenta, así que puedes empezar en cuanto termine la instalación.

De qué se encarga la extensión

• Árbol de conocimiento. Una barra lateral que muestra solo las rutas que contienen conocimiento, con la forma del repositorio, y con las memorias, reglas y skills agrupadas bajo cada ruta. Los conteos de contenido aparecen como insignias en las filas del árbol y en los archivos y carpetas correspondientes del explorador integrado.
• Sincronización con el archivo activo. A medida que pasas de un archivo a otro, el árbol sigue al editor hasta la ruta más profunda que cubre el archivo actual, y la barra de estado muestra esa ruta con sus conteos de contenido.
• Edición de contenido. Las memorias, reglas y skills se abren como pestañas Markdown normales del editor. Al guardar, los cambios se persisten a través de Pathrule, y tienes todas las herramientas del editor sin costo adicional.
• Configuración de agentes. Un solo comando conecta tus clientes de IA e instala los hooks vinculados a rutas, la misma configuración que realiza la CLI.
• Onboarding. Abre una carpeta que todavía no tenga espacio de trabajo y la extensión te guía desde la configuración hasta un espacio de trabajo vinculado sin salir del editor.
• Doctor. Un único comando que verifica que cada cliente esté conectado, que los hooks estén presentes y que el servidor de contexto sea accesible.

Modo local y modo Cloud

La extensión funciona en dos modos con una misma interfaz de usuario, la misma división que en la CLI y en el núcleo de código abierto.

• El modo local no requiere cuenta. Inicializa una carpeta en local y tus memorias, reglas y skills se guardan en tu máquina. Es la forma más rápida de empezar.
• El modo Cloud te hace iniciar sesión y añade la capa de equipo: conocimiento compartido, actividad del equipo y el backend gestionado.

El modo es una propiedad de la carpeta abierta, no una suposición. A un usuario con sesión iniciada cuya carpeta todavía no es un espacio de trabajo de Cloud se le ofrecen dos opciones: crear uno en la organización actual o inicializar en local. Cuando una carpeta está en modo local, las acciones exclusivas de la nube se ocultan en lugar de fallar, así que la misma extensión sirve para ambos casos.

Edición en pestañas Markdown

Abre una memoria, regla o skill desde el árbol y se abrirá como una pestaña Markdown normal. Edítala como cualquier archivo y guarda para persistir el cambio. Si alguien de tu equipo modificó el mismo elemento mientras lo tenías abierto, el guardado no sobrescribe su trabajo en silencio: se te ofrece recargar, conservar una copia de tu versión o sobrescribir con la tuya. Los conflictos se presentan como una decisión, nunca como ediciones perdidas.

Desde el explorador, haz clic derecho en cualquier archivo o carpeta para abrir un submenú de Pathrule: explora el conocimiento que aplica ahí o crea una nueva memoria, regla o skill vinculada a esa ruta. Desde un elemento del árbol puedes copiarlo como referencia para un prompt, ver sus detalles, renombrarlo, moverlo a otra ruta o eliminarlo con opción de deshacer. La selección múltiple permite mover y eliminar en bloque, y una búsqueda difusa abarca todos los títulos del espacio de trabajo.

Identidad compartida con la CLI

Iniciar sesión desde la extensión usa el mismo inicio de sesión alojado que la CLI, con GitHub, Google o correo electrónico, como prefieras. La sesión es compartida: al iniciar sesión aquí, también inicias sesión en la CLI, y si cambias de organización en una, cambia también en la otra. Una sola identidad para la extensión, la CLI y tu asistente de IA.

Conecta tus clientes de IA

Un único comando, Connect AI clients, conecta tu asistente con Pathrule sin editar JSON.

• El modo agente de GitHub Copilot recibe el servidor MCP de Pathrule, que la extensión registra para la carpeta vinculada.
• Claude Code, Codex, Cursor y Windsurf reciben entradas MCP gestionadas, escritas con el mismo instalador que usa la CLI.
• Los hooks se instalan con el mismo proceso que usa la CLI, y la notificación del resultado indica exactamente qué se escribió.

A partir de ahí, tu asistente recibe el contexto de Pathrule para la ruta actual por el canal que admite: hooks que incluyen un hook de prompt para Claude Code y Codex, hooks de sesión y de herramientas para Cursor y GitHub Copilot, y un archivo de reglas más MCP para Windsurf, que no tiene hooks. Ejecuta el comando doctor en cualquier momento para confirmar que cada cliente esté conectado y que los hooks estén actualizados.

Trabajo en equipo

Las escrituras en la nube se comparten, pero el backend actual de Cloud no ofrece suscripciones en tiempo real. Actualiza la vista de conocimiento o vuelve a solicitar el contexto para leer el estado más reciente; los hooks locales y los archivos de instrucciones usan el conocimiento preparado hasta que se actualizan. El trabajo a nivel de organización se queda en Pathrule Web: la gestión del equipo, los planes y la facturación, y la vista general de todos los espacios de trabajo se abren mediante enlaces en lugar de reimplementarse en el editor.

Si empezaste en modo local y quieres llevar una carpeta a tu equipo, una sola acción inicia tu sesión, elige una organización y copia el espacio de trabajo y su contenido a la nube, conservando tu copia local como respaldo.

Cuándo usar Pathrule para VS Code

Usa la extensión cuando trabajes principalmente en VS Code, Cursor o Windsurf y quieras el árbol de conocimiento del espacio de trabajo, la edición de contenido y la configuración de agentes en el editor que ya conoce tu carpeta abierta y tu archivo activo. Empieza en modo local en segundos e inicia sesión más adelante, cuando quieras la capa de equipo.

Si trabajas sobre todo en la terminal o integras Pathrule en CI mediante scripts, es mejor usar Pathrule CLI. Ambas comparten el mismo inicio de sesión, así que puedes usar las dos.

Qué leer a continuación

• Pathrule CLI, el entorno de ejecución centrado en la terminal que comparte la misma identidad y los mismos hooks.
• Núcleo de código abierto, para saber qué ejecuta el modo local y qué añade Cloud.
• Cómo funcionan los hooks, para ver qué le entrega la extensión a tu asistente.