notoetannoto/revdiff

O que revdiff faz?

Revise diffs, arquivos e documentos em um TUI com notas inline, exportando anotações estruturadas para scripts e ferramentas de IA.

Descrição

Esta skill permite revisar alterações (diffs), arquivos e documentação diretamente em um terminal interativo (TUI). Durante a revisão, é possível adicionar notas inline (em linha) para destacar pontos importantes, sugerir correções ou fazer observações. Ao final, as anotações são exportadas em formato estruturado (JSON, por exemplo), pronto para ser consumido por scripts, ferramentas de IA (como Claude, Cursor, Codex) ou pipelines de automação.

Como usar

1. Execute o comando revdiff informando o caminho para o diff, arquivo ou documento que deseja revisar.
2. Navegue pelo conteúdo usando as teclas de seta ou j/k.
3. Pressione i para entrar no modo de inserção de notas inline.
4. Escreva sua nota e pressione Esc para sair do modo de inserção.
5. Repita o processo para quantas anotações desejar.
6. Ao final, pressione q para sair e o arquivo de anotações será gerado automaticamente.

Recursos

• Interface TUI: Navegação por teclado, destaque de sintaxe e visualização lado a lado (split view) para diffs.
• Notas inline: Adicione comentários diretamente no contexto da linha revisada.
• Exportação estruturada: Gere um arquivo JSON com todas as anotações, incluindo metadados como arquivo, linha e conteúdo da nota.
• Integração com IA: O formato de saída é compatível com ferramentas de IA, permitindo que agentes como Claude ou Cursor utilizem as anotações para gerar resumos ou ações.

Exemplo de saída

{
  "revision": "2025-04-10T14:35:00Z",
  "files": [
    {
      "path": "src/main.py",
      "annotations": [
        {
          "line": 42,
          "note": "Considerar tratamento de exceção aqui",
          "type": "suggestion"
        }
      ]
    }
  ]
}

Configuração

# Definir diretório de saída
REVDIFF_OUTPUT_DIR="./annotations"

# Formato de exportação (json, yaml)
REVDIFF_FORMAT="json"

Licença

Distribuído sob licença MIT. Veja o arquivo LICENSE para mais detalhes.