Inicio rápido

Parte de un repositorio local y del agente que ya usas. La CLI es la forma de instalar Pathrule y de usarlo desde la terminal. Conecta los agentes compatibles en macOS, Linux o Windows, y el mismo conocimiento del espacio de trabajo está disponible desde la extensión de VS Code y a través de MCP. El modelo opcional en el dispositivo tiene sus propios requisitos de plataforma.

Si quieres explorar primero un proyecto local pequeño, sigue Espacio de trabajo de ejemplo. Lo creas y lo editas tú mismo.

1. Instala un entorno de ejecución

Instala la CLI con Node.js 20.11.1 o posterior:

npm i -g @pathrule/cli

• CLI ejecuta Pathrule en la terminal, por SSH y en automatizaciones. Consulta Instalación de la CLI para ver los requisitos en detalle.
• Extensión de VS Code te permite explorar y editar el conocimiento desde el editor, y también puede conectar tus clientes de IA. Consulta Pathrule para VS Code.

Puedes usar ambos con el mismo conocimiento del espacio de trabajo. En Cloud se conectan a través de tu cuenta. El uso local de la CLI no requiere cuenta.

2. Inicia sesión

pathrule setup te pide elegir Cloud o Local. Con Cloud inicias sesión para compartir el conocimiento del espacio de trabajo. Local no requiere cuenta. Usa pathrule setup --local para elegir Local directamente y omitir el inicio de sesión. En Local o Cloud se comparan ambas opciones. Continúa con el paso 3 para iniciar la configuración.

En Cloud, también puedes iniciar sesión por separado con un código de un solo uso, ya sea en un equipo de escritorio, por SSH o en una máquina sin interfaz gráfica:

pathrule login

La CLI muestra el código y abre la página de aprobación con el código ya completado. Si la máquina no tiene navegador, abre la URL que aparece en cualquier dispositivo, ingresa el código y aprueba el acceso. Si prefieres usar el flujo de callback del navegador en esta máquina, ejecuta pathrule login --browser-callback.

Con cualquiera de los dos flujos quedas con la sesión iniciada, y el entorno de ejecución mantiene esa sesión actualizada en segundo plano.

3. Crea un espacio de trabajo

El espacio de trabajo es la unidad a la que Pathrule asocia el contenido. Refleja un repositorio o un pequeño grupo de repositorios en tu máquina.

Con la CLI, todo ocurre en la carpeta donde la ejecutas, así que primero entra al repositorio. La ruta guiada crea o asocia el espacio de trabajo y conecta tus clientes de IA en una sola ejecución:

cd ~/repos/my-team
pathrule setup

La configuración muestra tu organización, sugiere espacios de trabajo que coinciden o crea uno para esta carpeta, y te pregunta qué clientes de IA compatibles quieres conectar. Después puede ofrecerte un primer análisis del proyecto, ejecutado por tu agente, que propone memorias, reglas y skills para que tú las apruebes. Para un espacio de trabajo que se guarde en esta máquina sin cuenta, ejecuta pathrule setup --local; consulta configuración local.

Para configurar Cloud manualmente, pathrule init crea un espacio de trabajo con el nombre de la carpeta y asocia la carpeta a él. Para asociar un espacio de trabajo de Cloud existente, indica su nombre o su id:

cd ~/repos/my-team
pathrule workspace attach my-team

No existe ninguna opción que reciba una ruta: la CLI siempre asocia la carpeta actual. Luego conecta tus clientes con pathrule install <client> y pathrule sync, como se describe en Instalación de la CLI. El entorno de ejecución usa esa asociación para resolver a qué espacio de trabajo corresponde tu directorio actual.

4. Escribe tu primera memoria

La forma más rápida de confirmar que todo está bien conectado es escribir una memoria y luego abrir tu asistente dentro del alcance que cubre. Para esta guía, colócala en la raíz del espacio de trabajo.

Title: Our database is Postgres on Supabase
Body:
- All queries should treat row level security as the source of truth.
- Do not bypass RLS with a service key in user facing code.
- Migrations live in supabase/migrations and run through CI.

Desde la terminal, en un espacio de trabajo de Cloud, crear la memoria es un solo comando. Si no indicas --body, la CLI abre tu editor (VISUAL o EDITOR) para que escribas el cuerpo; también puedes pasar --body o enviar el texto por una tubería.

pathrule memory add --path / --title "Our database is Postgres on Supabase"

Después ejecuta pathrule sync en el repositorio para que los archivos y el índice local que leen tus clientes incluyan la nueva memoria.

En VS Code, usa New Memory… en la vista de Pathrule. En un espacio de trabajo local, escribe en la Local Console o pídele a tu agente que la guarde mediante las herramientas MCP de Pathrule. La CLI lista, lee y busca conocimiento local, pero no lo agrega.

5. Observa cómo se activa el hook

Abre Claude Code o Codex en el directorio que asociaste al espacio de trabajo. Inicia un nuevo turno y haz cualquier pregunta relacionada con el área que cubre la memoria.

Cuando envías el prompt, el hook de Pathrule lee el fragmento en caché para esa ruta, da formato a las memorias y reglas relevantes y se las entrega al agente antes de su primera llamada a herramienta. Verás aparecer la memoria en la vista de contexto que ofrece tu agente, sin viajes de ida y vuelta adicionales a mitad de la tarea.

Cursor y GitHub Copilot no tienen hook de prompt: Pathrule les llega a través de hooks de sesión y de herramientas, sus archivos de instrucciones y MCP. Windsurf no tiene hooks y usa su archivo de reglas para iniciar la sesión y MCP para el contexto más profundo, así que verifica esos clientes con sus guías: Cursor, GitHub Copilot y Windsurf.

Si no aparece nada, ejecuta el diagnóstico.

pathrule doctor

El diagnóstico revisa tu inicio de sesión, el espacio de trabajo y si esta carpeta está asociada a él, la entrada MCP de cada cliente de IA y los archivos que Pathrule administra en la carpeta, y te indica el siguiente comando para todo lo que requiera atención. Una entrada de cliente desactualizada se corrige con pathrule repair.

6. Agrega una regla

Las memorias son hechos. Las reglas son restricciones. Agrega una regla en la misma ruta. En un espacio de trabajo de Cloud, desde la terminal:

pathrule rule add --path / --name "No service key in browser code" --priority high --scope folder \
  --body "Never use the SUPABASE_SERVICE_ROLE_KEY in any file under apps/web. Use the anon key plus row level security."

También puedes usar New Rule… en la extensión de VS Code, o pedirle a tu agente que guarde la regla.

Vuelve a abrir Claude Code. La regla llega junto con la memoria. La prioridad high la coloca cerca de los primeros lugares. Cuando se entrega como contexto, una regla es un requisito que se le indica al agente que cumpla, no un bloqueo. Una regla también puede incluir una restricción ejecutable: un agente puede proponerla, se guarda como propuesta y no se aplica, y solo después de que una persona la aprueba puede el hook previo a la herramienta bloquear una edición que coincida, en los clientes cuyos hooks de herramientas respetan esa decisión. Consulta Reglas como barreras de protección.

Qué leer a continuación

• Conceptos clave para conocer el modelo de datos detrás de las memorias, las reglas y las skills.
• Cómo funcionan los hooks para entender qué ocurre entre la caché y el agente.
• Descripción general de MCP para conocer las herramientas que usa tu asistente para leer y escribir contenido.
• Referencia de comandos de la CLI para ver todos los comandos de Pathrule CLI.