Minefy Seller CLI

Ganhe enquanto a IA pensa — sem patches, sem riscos, sem ToS violado.

O que é

O Minefy Seller CLI exibe anúncios patrocinados na barra de status do Claude Code enquanto o modelo processa. A cada chamada, o anúncio aparece na barra inferior junto com o saldo acumulado do dia.

A integração usa exclusivamente o campo oficial statusLine.command do arquivo de configuração do Claude Code (~/.claude/settings.json). Nenhum bundle é patchado, nenhuma CSP é alterada, nenhum código remoto é baixado em runtime.

Diferencial

Concorrentes como kickbacks.ai patcham o bundle do Claude Code e enfraquecem a CSP — isso viola os Termos de Serviço da Anthropic e expõe o usuário. O Minefy Seller funciona pelo caminho correto: a Anthropic expõe statusLine.command exatamente para isso.

Instalação

npm install -g minefy-seller-cli

Ou, sem instalar globalmente:

npx minefy-seller-cli login --token <jwt>

Uso

1. Autenticar

Obtenha seu token em conta.minefyseller.com → Configurações → API Key.

minefy-seller login --token eyJhbGci...

O token é salvo em ~/.minefy-seller/config.json com permissão 600.

2. Plugar no Claude Code

Execute para ver as instruções e o trecho exato de configuração:

minefy-seller setup

Para que o Claude Code aplique automaticamente (com sua confirmação):

minefy-seller setup --apply

3. Trecho de configuração (manual)

Adicione ao seu ~/.claude/settings.json:

{
  "statusLine": {
    "command": "minefy-seller statusline"
  }
}

Reinicie o Claude Code. A barra de status passará a exibir:

💸 R$0,12 hoje · Linear — issue tracking ↗

Outros comandos

minefy-seller whoami      # Mostra token salvo (truncado)
minefy-seller logout      # Remove o token local
minefy-seller statusline  # Imprime a linha (teste manual)

Variáveis de ambiente

| Variável | Padrão | Descrição | |---|---|---| | MINEFY_SELLER_API_URL | https://api.minefyseller.com | URL base da API | | MINEFY_SELLER_CACHE_TTL_S | 60 | TTL do cache de anúncios (segundos) | | MINEFY_SELLER_NO_EMOJI | 0 | Desativa emojis na linha (1 = sem emoji) |

Antifraude — modelo conservador (transparência total)

O terminal não oferece APIs de visibilidade como o browser (IntersectionObserver, document.visibilityState, foco de janela, etc.). Por isso o Minefy Seller adota uma política declarada e conservadora:

• 1 impressão por janela de TTL (padrão 60 s). ad/complete é disparado uma única vez por janela, não por execução do comando.
• watchedMs = minWatchMs retornado pela API — o mínimo honesto declarado pelo servidor. Nunca inflamos esse valor.
• Cache em disco (~/.minefy-seller/statusline-cache.json, permissão 600) evita múltiplas chamadas ao ad/request dentro do TTL.

Esse modelo é documentado no código (src/commands/statusline.ts) e aqui para total transparência com anunciantes e usuários.

Como o Claude Code executa o statusLine

O campo statusLine.command é um ponto de extensão oficial da Anthropic. O Claude Code executa o comando de shell especificado e exibe a última linha do stdout na barra de status. Não há acesso ao contexto da conversa, ao modelo ou ao bundle — é apenas um processo filho que imprime texto.

Referência: Claude Code Settings

Arquitetura

cli/
  src/
    index.ts              # Ponto de entrada, definição dos comandos (Commander)
    config.ts             # Leitura/gravação de ~/.minefy-seller/config.json (chmod 600)
    api.ts                # Cliente fetch para POST /ad/request e /ad/complete
    cache.ts              # Cache em memória (auxiliar — cache principal é em disco)
    commands/
      login.ts            # minefy-seller login --token <jwt>
      statusline.ts       # minefy-seller statusline  (core do produto)
      setup.ts            # minefy-seller setup [--apply]
  dist/                   # Saída do tsc (não commitado)
  package.json
  tsconfig.json

Desenvolvimento

cd cli
npm install
npm run build    # tsc — sem erro = pronto
node dist/index.js --help

Publicar no npm

O pacote esta pronto para publicacao. Execute como o CEO (conta npm da Minefy):

# 1. Autentique-se no npm (uma vez)
npm login

# 2. Build + publish (prepublishOnly roda o build automaticamente)
cd cli && npm publish --access public

O pacote sera publicado como minefy-seller-cli no registro publico do npm. Versao: verifique/incremente version em cli/package.json antes de publicar.

Licenca

MIT — Minefy Mining System LTDA