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
Forefront
Forefront · ProgramaciónForefront es una plataforma web para construir con IA de código abierto. Te deja ajustar los principales modelos de lenguaje de código abierto con tus propios datos, evaluar cómo rinden y ejecutarlos a través de una API o exportarlos para alojarlos tú mismo. Los desarrolladores que quieren la comodidad de una plataforma cerrada pero insisten en ser dueños de sus modelos y sus datos son el público objetivo.
Startkit
StartKit.AI · ProgramaciónStartkit es un boilerplate para crear productos de SaaS con IA y wrappers de IA. Piénsalo como un boilerplate para startups de IA con las partes aburridas ya conectadas: autenticación, pagos con Stripe y Lemon Squeezy, límites de uso, correo transaccional y un kit de inicio de API de IA que habla con OpenAI, Anthropic, Groq o Llama. Clonas el repositorio, pones tu precio y te dedicas a la parte del producto por la que la gente paga de verdad. Está hecho con Next.js sobre React y Tailwind, así que buena parte del código boilerplate ya te resulta familiar.
Testim
Tricentis · ProgramaciónTestim es una plataforma de automatización de pruebas impulsada por IA para crear y ejecutar pruebas de extremo a extremo en aplicaciones web, móviles y Salesforce. Se apoya en el aprendizaje automático para mantener las pruebas estables cuando cambia una interfaz, así que los equipos dedican menos tiempo a reparar selectores rotos. No está nada mal para una herramienta de pruebas automatizadas que puedes empezar a usar hoy mismo. Creas pruebas grabando acciones en un navegador y luego añades JavaScript cuando necesitas más control. Es una opción sólida para equipos de QA con mucho trabajo.