📎 Clippy SQL

CLI para traduzir linguagem natural em comandos SQL usando OpenRouter.

Instalação

bun install

Configuração

Configure sua chave de API do OpenRouter:

export OPENROUTER_API_KEY=sua-chave-aqui

Opcionalmente, defina um modelo padrão:

export OPENROUTER_MODEL=anthropic/claude-3.5-sonnet

Uso

Consulta simples

bun run cli.ts "liste todos os usuários ativos"

Com explicação detalhada

bun run cli.ts -e "encontre pedidos maiores que 1000 reais do último mês"

Com schema do banco

bun run cli.ts -s example-schema.sql "total de vendas por categoria"

Modo interativo

bun run cli.ts -i

No modo interativo, comandos disponíveis:

• /explain - Alterna modo explicação
• /schema <arquivo> - Carrega um arquivo de schema
• /model <modelo> - Altera o modelo
• /copy - Copia último SQL para clipboard
• /quit - Sair

Opções

| Opção | Descrição | |-------|-----------| | -e, --explain | Inclui explicação detalhada do SQL | | -s, --schema | Arquivo com o schema do banco | | -m, --model | Modelo do OpenRouter | | -i, --interactive | Modo interativo (REPL) | | -c, --copy | Copia o SQL para clipboard | | -h, --help | Mostra ajuda | | -v, --version | Mostra versão |

Exemplos

# Consulta simples
bun run cli.ts "mostre os 10 produtos mais vendidos"

# Com explicação
bun run cli.ts -e "calcule a média de vendas por mês"

# Usando schema customizado
bun run cli.ts -s meu-schema.sql "usuários que compraram mais de 5 vezes"

# Copiando para clipboard
bun run cli.ts -c "total de vendas do último trimestre"