agent-sh/agnix

O que agnix faz?

O linter e LSP que faltava para assistentes de codificação com IA. Valide CLAUDE.md, AGENTS.md, SKILL.md, hooks, MCP. Inclui plugin para todos os principais IDEs, com correções automáticas.

Visão Geral

O agnix é uma ferramenta de linha de comando e servidor de protocolo de linguagem (LSP) projetada especificamente para validar e corrigir arquivos de configuração usados por assistentes de codificação com IA. Ele verifica a sintaxe, a estrutura e a conformidade de arquivos como:

• CLAUDE.md
• AGENTS.md
• SKILL.md
• Hooks (scripts personalizados)
• MCP (Model Context Protocol)

Instalação

# npm
npm install -g agnix

# yarn
yarn global add agnix

# brew (macOS/Linux)
brew install agent-sh/tap/agnix

Uso

Linha de Comando

# Validar todos os arquivos no diretório atual
agnix lint

# Corrigir automaticamente os problemas encontrados
agnix fix

# Iniciar o servidor LSP
agnix lsp

Plugin para IDE

O agnix oferece plugins para os principais IDEs:

• VS Code: Pesquise por "agnix" no marketplace.
• JetBrains (IntelliJ, WebStorm, etc.): Plugin disponível no repositório oficial.
• Vim/Neovim: Suporte via LSP nativo ou plugin dedicado.
• Emacs: Integração via lsp-mode.

Após a instalação, o plugin validará automaticamente os arquivos suportados e fornecerá diagnósticos em tempo real, realce de erros e correções rápidas.

Configuração

Você pode criar um arquivo .agnixrc na raiz do seu projeto para personalizar o comportamento:

{
  "rules": {
    "hook-order": "error",
    "mcp-version": "warn",
    "skill-format": "error"
  },
  "ignore": ["node_modules/**"]
}

Hooks

Hooks são scripts que executam em eventos específicos do ciclo de vida do assistente de IA. O agnix verifica:

• Se a estrutura do diretório de hooks está correta.
• Se cada hook possui permissões de execução.
• Se os nomes dos hooks seguem a convenção esperada (ex: pre-commit, post-request).

MCP (Model Context Protocol)

O agnix valida definições MCP, garantindo que:

• Os endpoints estejam bem formados.
• Os schemas de entrada/saída sejam válidos.
• As configurações de segurança estejam corretas.

Integração Contínua

Adicione o agnix ao seu pipeline de CI/CD para garantir que as configurações estejam sempre válidas:

# .github/workflows/validate.yml
name: Validar Configurações de IA
on: [push, pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g agnix
      - run: agnix lint

Suporte e Contribuição

• Issues: https://github.com/agent-sh/agnix/issues
• Documentação completa: https://agent-sh.dev/agnix
• Contribuições: Pull requests são bem-vindos! Consulte o guia de contribuição no repositório.

Licença

MIT