Primeros pasos

agentsync es una herramienta CLI rápida y portable para sincronizar configuraciones de agentes de IA entre distintos asistentes de programación mediante enlaces simbólicos.

Instalación

Administradores de paquetes de Node.js (recomendado)

Si tienes Node.js (>=18), la forma más sencilla de instalar AgentSync es usar un administrador de paquetes.

Instalación global

# Con npm
npm install -g @dallay/agentsync

# Con pnpm
pnpm add -g @dallay/agentsync

# Con yarn (Classic v1)
yarn global add @dallay/agentsync

# Con bun
bun i -g @dallay/agentsync

Ejecución puntual

# Con npx (npm)
npx @dallay/agentsync apply

# Con dlx (pnpm)
pnpm dlx @dallay/agentsync apply

# Con dlx (yarn v2+)
yarn dlx @dallay/agentsync apply

# Con bunx (bun)
bunx @dallay/agentsync apply

Desde GitHub Releases

Descarga la versión más reciente para tu plataforma. Los binarios se adjuntan a la página de GitHub Releases. El nombre del recurso incluye la versión; usa GitHub CLI para seleccionar el archivo de tu plataforma. Este ejemplo descarga el archivo para Apple Silicon en macOS:

gh release download --repo dallay/agentsync --pattern '*aarch64-apple-darwin.tar.gz'
tar xzf agentsync-*-aarch64-apple-darwin.tar.gz
sudo install agentsync-*/agentsync /usr/local/bin/agentsync

Los destinos disponibles incluyen Linux x64/ARM64 con GNU o musl (x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu, x86_64-unknown-linux-musl, aarch64-unknown-linux-musl), macOS x64/ARM64 y Windows x64. Para usar un binario descargado, asegúrate de que esté en tu PATH.

En Windows

Para crear enlaces simbólicos, Windows requiere permisos o el modo de desarrollador. Consulta la guía de configuración de symlinks en Windows si agentsync apply no puede crear enlaces.

Inicializa AgentSync

Desde la raíz del proyecto, ejecuta el asistente interactivo:

npx @dallay/agentsync init --wizard

pnpm dlx @dallay/agentsync init --wizard

yarn dlx @dallay/agentsync init --wizard

bunx @dallay/agentsync init --wizard

El asistente te ayuda a elegir asistentes, fuentes y destinos. También puedes crear la estructura básica sin el asistente:

npx @dallay/agentsync init

pnpm dlx @dallay/agentsync init

yarn dlx @dallay/agentsync init

bunx @dallay/agentsync init

Esto crea la configuración y los archivos de origen que AgentSync necesita. Revisa agentsync.toml antes de sincronizar.

Prepara una fuente

Por ejemplo, crea .agents/AGENTS.md con las instrucciones compartidas del proyecto. Puedes agregar skills, comandos y servidores MCP en los archivos y directorios que especifique la configuración:

.agents/
├── AGENTS.md
├── skills/
├── commands/
└── agentsync.toml

Revisa y aplica

Antes de modificar archivos, inspecciona el plan:

npx @dallay/agentsync inspect

pnpm dlx @dallay/agentsync inspect

yarn dlx @dallay/agentsync inspect

bunx @dallay/agentsync inspect

npx @dallay/agentsync apply --dry-run

pnpm dlx @dallay/agentsync apply --dry-run

yarn dlx @dallay/agentsync apply --dry-run

bunx @dallay/agentsync apply --dry-run

Si el resultado es correcto, aplica la sincronización y comprueba el estado:

npx @dallay/agentsync apply

pnpm dlx @dallay/agentsync apply

yarn dlx @dallay/agentsync apply

bunx @dallay/agentsync apply

npx @dallay/agentsync status

pnpm dlx @dallay/agentsync status

yarn dlx @dallay/agentsync status

bunx @dallay/agentsync status

inspect y --dry-run permiten revisar los destinos antes de modificarlos. Usa status para comprobar el resultado después de aplicar. Consulta Archivos de instrucciones y Tipos de sincronización para elegir fuentes y destinos apropiados.

Próximos pasos

Configura las fuentes y destinos en agentsync.toml.
Revisa las recetas de configuración para patrones habituales.
Ejecuta agentsync doctor para diagnosticar el entorno.

Inicializa AgentSync

En la raíz del proyecto, ejecuta el asistente interactivo:

agentsync init --wizard

El asistente te ayuda a elegir asistentes, fuentes y destinos. También puedes crear la estructura básica sin el asistente:

agentsync init

Esto crea la configuración y los archivos de origen que AgentSync necesita. Revisa agentsync.toml antes de sincronizar.

Prepara una fuente

Por ejemplo, crea .agents/AGENTS.md con las instrucciones compartidas de tu proyecto. Puedes agregar skills, comandos y servidores MCP en los directorios y archivos que especifique la configuración.

.agents/
├── AGENTS.md
├── skills/
└── agentsync.toml

Revisa y aplica

Antes de cambiar archivos, inspecciona el plan:

agentsync inspect
agentsync apply --dry-run

Si el resultado es correcto, aplica la sincronización:

agentsync apply
agentsync status

inspect y --dry-run te permiten revisar destinos antes de modificarlos. Usa status para comprobar el estado después de aplicar. Consulta Archivos de instrucciones y Tipos de sincronización para elegir las fuentes y destinos apropiados.

Próximos pasos

Configura las fuentes y los destinos en agentsync.toml.
Revisa las recetas de configuración para patrones habituales.
Ejecuta agentsync doctor si necesitas diagnosticar el entorno.