open-AIMS/cite-assist

O que cite-assist faz?

Adiciona citações APA a relatórios a partir da sua biblioteca Zotero. Fornece uma habilidade portátil de agente de IA para VS Code, Codex e Claude Code, além da CLI refcite integrada para armazenar fontes em cache, classificar candidatos a citação, escrever arquivos de revisão e inserir citações e referências.

Recursos

• Sincroniza automaticamente com sua biblioteca Zotero.
• Armazena referências em cache localmente para acesso offline rápido.
• Usa ranqueamento inteligente para sugerir as melhores citações com base no contexto.
• Insere citações formatadas em APA diretamente nos seus documentos.
• Gera lista de referências completa no final do relatório.
• Cria arquivos de revisão para verificação e edição humana.

Plataformas Suportadas

• VS Code com a extensão Codex
• Claude Code (ferramenta de linha de comando)
• refcite CLI (bundled)

Como Usar

Pré-requisitos

• Ter o Zotero instalado e sincronizado com sua conta.
• Ter a habilidade carregada no seu agente de IA (VS Code, Codex ou Claude Code).
• Para uso via CLI: instalar o refcite globalmente ou via npx.

Inserir uma Citação

1. Escreva o texto do seu relatório normalmente.
2. Quando precisar de uma citação, use o comando do agente (ex: /cite no Claude Code) ou a CLI refcite insert.
3. O agente consultará o cache local do Zotero e sugerirá as fontes mais relevantes.
4. Selecione a fonte desejada; a citação no formato APA será inserida automaticamente.
5. Ao final do documento, execute o comando para gerar a lista de referências.

Exemplo de Uso via CLI

# Sincronizar cache com Zotero
refcite sync

# Inserir citação no documento atual
refcite insert --file relatorio.md --query "aprendizado de máquina"

# Gerar lista de referências
refcite references --file relatorio.md

Estrutura do Cache

O cache local é armazenado em ~/.refcite/sources.json com a seguinte estrutura:

{
  "sourceKey": {
    "title": "Título do Artigo",
    "authors": ["Sobrenome, N.", "Sobrenome2, N."],
    "year": 2023,
    "journal": "Nome do Periódico",
    "doi": "10.1234/example.doi"
  }
}

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório open-AIMS/cite-assist.

Licença

Este projeto está licenciado sob a licença MIT.