
agent-harness
ar27111994 · Programación · Productividad
agent-harness es una CLI de código abierto que gestiona los recursos reutilizables que alimentan a los agentes de programación con IA, como skills, servidores MCP, instrucciones y paquetes de prompts. Si alguna vez has deseado un gestor de paquetes para servidores MCP, esto se le parece bastante. Escanea un espacio de trabajo, elige los recursos que encajan con la tarea, los replica en una copia local fijada y luego los conecta al host que uses, ya sea VS Code, Cursor, Zed, Claude Code, OpenCode, Pi o Codex. Para una CLI destinada a agentes de IA, la tarea es estrecha y clara: decidir qué puede usar tu agente.

Acerca de agent-harness
Qué es agent-harness
agent-harness es una CLI de Node.js y TypeScript que se encarga de la parte aburrida y propensa a errores de trabajar con agentes de programación con IA: mantener ordenados sus recursos reutilizables. Hay quien lo describe como un gestor de recursos para agentes de IA, y la etiqueta encaja. La mayoría de los desarrolladores ya hace malabares con skills, servidores MCP, archivos de instrucciones y paquetes de prompts entre más de un editor. Cada herramienta quiere esos recursos en un sitio distinto y con un formato distinto. agent-harness convierte ese lío en un único ciclo de vida repetible.
No ejecuta agentes. Prepara entradas inspeccionables para el host que ya usas, para que veas qué entra en tu espacio de trabajo antes de que cambie nada. El modelo central es deliberadamente simple: una sola superficie de comandos, una capa de adaptadores de host, escrituras con vista previa primero y pasos de instalación nativa explícitos. El proyecto tiene licencia MIT y vive en GitHub.
La principal limitación es su alcance. Gestiona recursos para siete hosts de programación y exige Node 23 o superior, así que todavía no sirve de nada si tu flujo de trabajo ocurre por completo en el navegador o en una herramienta que no está en la lista compatible. Entonces, ¿quién debería pasar de él? Cualquiera que solo toque un host y nunca cambie la configuración. Además es joven, así que hay menos historias reales que en los gestores de paquetes más grandes.
Primeros pasos
- Instala Node.js 23 o superior, más npm y Git, y luego ejecuta
npm install -g @ar27111994/agent-harness. - Desde el espacio de trabajo que quieras configurar, consulta qué soporta tu host con
agent-harness setup hostsyagent-harness setup doctor --host vscode(cambia por tu propio host). - Ejecuta todo el proceso de una sola vez:
agent-harness workspace opencode --intent general, eligiendo una intención comofrontendoresearchque encaje con tu proyecto. - Inspecciona la carpeta
.agent-harness/generada para revisar qué se descubrió, seleccionó y preparó. - Vuelve a ejecutar el mismo comando cuando cambien tus necesidades, usando primero el modo de vista previa si quieres ver los cambios de archivos previstos antes de que se apliquen.
Información del producto
Un vistazo rápido a los precios, las plataformas compatibles y el rendimiento de agent-harness.
Ideal para
Los usuarios, tareas y casos de uso en los que esta herramienta encaja mejor.
Usuarios
- Desarrolladores que hacen malabares con más de un host de programación con IA
- Equipos que quieren configuraciones repetibles
- Colaboradores de código abierto y curiosos
Tareas
- Instalar y conectar servidores MCP
- Gestionar skills e instrucciones de agentes
- Auditar a qué puede acceder un agente
- Refrescar una configuración existente
Casos de uso
- Cambiar de editor a mitad de proyecto
- Incorporar a un compañero
- Mantener fuera las entradas de riesgo
Funciones clave
Ciclo de vida de recursos entre hosts
agent-harness ejecuta el mismo ciclo de vida sin importar qué host elijas: descubrir, recomendar, replicar, preparar, activar y conectar. Esa consistencia importa porque las herramientas subyacentes no coinciden en nada. Una skill que funciona en Claude Code no se empaqueta igual que una para Cursor, y este instrumento suaviza esas diferencias detrás de una sola superficie de comandos. Una superficie, un ciclo de vida.
Configuración del espacio de trabajo con un comando
El comando workspace <host> es la ruta por defecto para los usuarios nuevos. Hace un descubrimiento amplio, ordena los candidatos, prepara y activa los recursos elegidos y termina con la conexión del host, todo desde una sola línea como agent-harness workspace cursor --intent frontend. Intenciones como devops, design o research orientan la selección hacia tu tipo de trabajo, y puedes pasar más de una. La configuración es una línea. Eso es lo atractivo.
Conexión con vista previa primero
Conectar un host no modifica nada salvo que lo pidas. Por defecto, wire <host> escribe un plan revisable y no toca nada. Puedes leer las rutas de destino exactas y las escrituras previstas, y luego aplicar o reiniciar cuando estés listo. Para quien haya visto a una herramienta reescribir en silencio la configuración del editor, eso es una raya en la arena bienvenida.
Espejos fijados y cuarentena
En vez de traer recursos directamente de internet a tu espacio de trabajo, la herramienta replica un conjunto acotado en artefactos locales reproducibles y fija cada generación. Los candidatos que parecen arriesgados pasan por una carpeta de cuarentena en lugar de activarse. El resultado es una configuración que puedes inspeccionar y revertir, y no una que se mueve bajo tus pies.
Publicador y consumidor ARD
agent-harness implementa la especificación Agentic Resource Discovery 1.0, el estándar respaldado por Google, Microsoft, Hugging Face, GitHub y NVIDIA. Publica un .well-known/ai-catalog.json para que los registros puedan indexar sus recursos seleccionados, y puede consumir otros registros ARD como fuentes de descubrimiento. Su lema resume la intención: descubre en cualquier lugar, instala en todas partes.
Siete adaptadores de host
El proyecto registra adaptadores para VS Code con Copilot, OpenCode, Cursor, Zed, Claude Code, Pi y OpenAI Codex. Cada adaptador controla los archivos, la configuración, el comportamiento de aplicar y reiniciar, y los límites de seguridad de su host. Algunos reutilizan la estructura de paquetes de otro host mientras ordenan según su propia política, lo que mantiene a Cursor, por ejemplo, compatible con recursos al estilo Copilot.
Recomendaciones conscientes de la intención
Las recomendaciones sopesan política, señales de demanda, confianza, coste y diversidad, no solo la popularidad. Se prefieren las fuentes oficiales y verificadas, y las fuentes propias bajan de posición cuando la evidencia del propietario no cuadra. El resultado es que aterrizan menos paquetes dudosos en tu espacio de trabajo y más de los que encajan de verdad con lo que construyes.
Ventajas y desventajas
Ventajas
- Resuelve un problema real en siete hosts populares de programación con IA con una sola superficie de comandos
- Las escrituras con vista previa primero y los espejos fijados hacen que los cambios sean inspeccionables y reversibles
- Es gratis y de código abierto bajo MIT, con una arquitectura de adaptadores limpia para extensiones
- El manejo de cuarentena y la ordenación consciente de la confianza añaden una capa de cautela en la cadena de suministro
Desventajas
- Exige Node.js 23 o superior, así que las configuraciones antiguas necesitan una actualización primero
- Sin soporte para navegador ni para hosts fuera de la CLI, lo que deja fuera algunos flujos de trabajo por completo
- Todavía es joven y con una base de usuarios pequeña, así que los casos límite y la documentación pueden ir por detrás
- Supone soltura con la terminal, lo que lo aleja de los usuarios ocasionales
Preguntas frecuentes
Gestiona los recursos reutilizables de los que dependen los agentes de programación con IA, como skills, servidores MCP, instrucciones y paquetes de prompts. Descubre candidatos, los ordena, replica una copia local fijada y luego conecta los elegidos a tu host. No ejecuta agentes por sí mismo.
Contenido relacionado
Explora herramientas, habilidades y artículos relacionados con agent-harness.
Alternativas a agent-harness
Base Code
Base44 (Wix) · Programación · ProductividadBase Code es un entorno de desarrollo en la nube compartido de Base44. El equipo describe cambios sobre un repositorio de GitHub en el chat, los ve en una vista previa y los envía como pull requests.
Google EmbeddingGemma 2
Google DeepMind · Escritura · Imagen · ProgramaciónGoogle EmbeddingGemma 2 es un modelo abierto de 740 millones de parámetros que convierte texto, código, imágenes, audio y fotogramas de vídeo en vectores de un mismo espacio de 768 dimensiones, y funciona en móviles y portátiles.
GitGlow
GitGlow · Programación · ProductividadGitGlow es un cliente Git de escritorio que reúne tu código y los cambios de tus agentes de IA en una sola revisión, para que sepas qué va a salir de tu máquina antes de publicarlo.
