agent-harness

agent-harness

ar27111994 · Programação · Produtividade

agent-harness é uma CLI de código aberto que gerencia os recursos reutilizáveis que alimentam os agentes de programação com IA, como skills, servidores MCP, instruções e pacotes de prompts. Se você sempre quis um gerenciador de pacotes para servidores MCP, isto chega perto disso. Ele varre um espaço de trabalho, escolhe os recursos que combinam com o trabalho, espelha-os numa cópia local fixada e depois os conecta ao host que você usa, seja VS Code, Cursor, Zed, Claude Code, OpenCode, Pi ou Codex. Para uma CLI destinada a agentes de IA, a tarefa é estreita e clara: decidir o que o seu agente pode usar.

Prévia da interface de agent-harness

Sobre agent-harness

O que é o agent-harness

agent-harness é uma CLI de Node.js e TypeScript que cuida da parte chata e propensa a erros de trabalhar com agentes de programação com IA: manter os recursos reutilizáveis em ordem. Alguns o descrevem como um gerenciador de recursos para agentes de IA, e o rótulo encaixa. A maioria dos desenvolvedores já equilibra skills, servidores MCP, arquivos de instruções e pacotes de prompts entre mais de um editor. Cada ferramenta quer esses recursos num lugar diferente e num formato diferente. O agent-harness transforma essa bagunça num único ciclo de vida repetível.

Ele não executa agentes. Prepara entradas inspecionáveis para o host que você já usa, para que você veja o que entra no seu espaço de trabalho antes de qualquer mudança. O modelo central é deliberadamente simples: uma única superfície de comando, uma camada de adaptadores de host, gravações com prévia primeiro e etapas explícitas de instalação nativa. O projeto tem licença MIT e fica no GitHub.

A principal limitação é o alcance. Ele gerencia recursos para sete hosts de programação e exige Node 23 ou superior, então ainda não serve para nada se o seu fluxo de trabalho acontece inteiramente no navegador ou numa ferramenta que não está na lista compatível. Então, quem deveria pular fora? Quem só toca um host e nunca muda as configurações. Além disso, é jovem, o que significa menos histórias do mundo real do que os gerenciadores de pacotes maiores têm.

Primeiros passos

  1. Instale o Node.js 23 ou superior, além do npm e do Git, e depois rode npm install -g @ar27111994/agent-harness.
  2. No espaço de trabalho que você quer configurar, verifique o que o seu host suporta com agent-harness setup hosts e agent-harness setup doctor --host vscode (troque pelo seu próprio host).
  3. Rode o fluxo completo de uma só vez: agent-harness workspace opencode --intent general, escolhendo uma intenção como frontend ou research que combine com o seu projeto.
  4. Inspecione a pasta .agent-harness/ gerada para revisar o que foi descoberto, selecionado e preparado.
  5. Rode o mesmo comando de novo sempre que suas necessidades mudarem, usando o modo de prévia primeiro se quiser ver as mudanças de arquivos planejadas antes de serem aplicadas.

Informações do produto

Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de agent-harness.

Plano gratuitoSim
Planos pagos$0
PlataformaWindows, macOS, Linux (Node.js 23+)
Desenvolvedorar27111994
CategoriaProgramação · Produtividade
Data de lançamentoApr 2026
Última atualizaçãoSep 2026
Visitas ao site649.3M
Ranking global do site50
Disponibilidade da APINão

Ideal para

Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.

Usuários

  • Desenvolvedores que equilibram mais de um host de programação com IA
  • Equipes que querem configurações repetíveis
  • Colaboradores de código aberto e curiosos

Tarefas

  • Instalar e conectar servidores MCP
  • Gerenciar skills e instruções de agentes
  • Auditar a que um agente pode acessar
  • Atualizar uma configuração existente

Cenários

  • Trocar de editor no meio do projeto
  • Integrar um colega
  • Manter entradas arriscadas de fora

Principais recursos

Ciclo de vida de recursos entre hosts

O agent-harness roda o mesmo ciclo de vida independentemente do host que você escolher: descobrir, recomendar, espelhar, preparar, ativar e conectar. Essa consistência importa porque as ferramentas por baixo não concordam em nada. Uma skill que funciona no Claude Code não é empacotada do mesmo jeito que uma para o Cursor, e esta ferramenta alisa essas diferenças atrás de uma única superfície de comando. Uma superfície, um ciclo de vida.

Configuração do espaço de trabalho com um comando

O comando workspace <host> é o caminho padrão para usuários novos. Ele faz uma descoberta ampla, ordena os candidatos, prepara e ativa os recursos escolhidos e termina com a conexão do host, tudo numa única linha como agent-harness workspace cursor --intent frontend. Intenções como devops, design ou research direcionam a seleção para o seu tipo de trabalho, e você pode passar mais de uma. A configuração é uma linha. Esse é o atrativo.

Conexão com prévia primeiro

Conectar um host não modifica nada a menos que você peça. Por padrão, wire <host> grava um plano revisável e não toca em nada. Você pode ler os caminhos de destino exatos e as gravações planejadas, e depois aplicar ou reiniciar quando estiver pronto. Para quem já viu uma ferramenta reescrever as configurações do editor em silêncio, essa é uma linha na areia bem-vinda.

Espelhos fixados e quarentena

Em vez de puxar recursos direto da internet para o seu espaço de trabalho, a ferramenta espelha um conjunto limitado em artefatos locais reproduzíveis e fixa cada geração. Os candidatos que parecem arriscados passam por uma pasta de quarentena em vez de serem ativados. O resultado é uma configuração que você pode inspecionar e reverter, e não uma que se move sob os seus pés.

Publicador e consumidor ARD

O agent-harness implementa a especificação Agentic Resource Discovery 1.0, o padrão apoiado por Google, Microsoft, Hugging Face, GitHub e NVIDIA. Ele publica um .well-known/ai-catalog.json para que os registros possam indexar seus recursos selecionados, e pode consumir outros registros ARD como fontes de descoberta. Seu slogan resume a intenção: descubra em qualquer lugar, instale em todos os lugares.

Sete adaptadores de host

O projeto registra adaptadores para VS Code com Copilot, OpenCode, Cursor, Zed, Claude Code, Pi e OpenAI Codex. Cada adaptador cuida dos arquivos, das configurações, do comportamento de aplicar e reiniciar e dos limites de segurança do seu host. Alguns reutilizam o layout de pacotes de outro host enquanto ordenam pela própria política, o que mantém o Cursor, por exemplo, compatível com recursos no estilo Copilot.

Recomendações conscientes da intenção

As recomendações pesam política, sinais de demanda, confiança, custo e diversidade, não apenas popularidade. Fontes oficiais e verificadas são preferidas, e fontes próprias caem de posição quando a evidência do proprietário não bate. O resultado é menos pacotes duvidosos aterrissando no seu espaço de trabalho e mais daqueles que realmente combinam com o que você está construindo.

Prós e contras

Prós

  • Resolve um problema real em sete hosts populares de programação com IA com uma única superfície de comando
  • Gravações com prévia primeiro e espelhos fixados tornam as mudanças inspecionáveis e reversíveis
  • É gratuito e de código aberto sob MIT, com uma arquitetura de adaptadores limpa para extensões
  • O tratamento de quarentena e a ordenação consciente da confiança acrescentam uma camada de cautela na cadeia de suprimentos

Contras

  • Exige Node.js 23 ou superior, então configurações antigas precisam de uma atualização primeiro
  • Sem suporte a navegador ou a hosts fora da CLI, o que deixa de fora alguns fluxos de trabalho por completo
  • Ainda é novo e com uma base pequena de usuários, então os casos extremos e a documentação podem ficar para trás
  • Supõe familiaridade com o terminal, o que o afasta dos usuários casuais

Perguntas frequentes

Ele gerencia os recursos reutilizáveis dos quais os agentes de programação com IA dependem, como skills, servidores MCP, instruções e pacotes de prompts. Descobre candidatos, ordena-os, espelha uma cópia local fixada e depois conecta os escolhidos ao seu host. Ele não executa agentes por conta própria.

Conteúdo relacionado

Explore ferramentas, skills e artigos relacionados a agent-harness.

Alternativas a agent-harness

Forefront

Forefront

Forefront · Programação

O Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.

Grátis / $0 - $99/moVer detalhes
Startkit

Startkit

StartKit.AI · Programação

Startkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.

Pago / $99 - $499 one-timeVer detalhes
Testim

Testim

Tricentis · Programação

O Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.

Grátis / Custom pricing on requestVer detalhes