← Docs

Perguntas Frequentes

O que acontece com meus dados de custo rastreados quando eu excluo uma regra de cobrança?
Seus dados de custo são sempre preservados. Excluir uma regra de cobrança remove apenas a própria regra — nunca altera seu histórico de custos rastreados. Os custos que antes estavam associados a essa regra simplesmente ficam sem atribuição e reaparecem na sua visualização de Custos Não Atribuídos na próxima vez que você abrir o painel. A partir daí, você pode remapeá-los para um projeto ou cliente diferente a qualquer momento.
Se eu remapear custos para um projeto diferente após excluir uma regra de cobrança, o remapeamento se aplica aos custos passados também?
Sim — o remapeamento se aplica retroativamente a todos os custos registrados desde que a extensão foi instalada. Seus eventos de custo bruto são armazenados permanentemente no banco de dados local e nunca estão vinculados a uma regra de cobrança específica. Quando você adiciona um novo mapeamento, o mecanismo de sincronização o compara com todo o seu histórico registrado. Na próxima vez que você executar Sincronizar Agora ou Backfill, entradas de tempo são criadas ou atualizadas no seu software de cobrança para cada dia correspondente no passado, incluindo dias que estavam anteriormente sem atribuição. Nada é perdido entre o momento em que você exclui uma regra e o momento em que cria uma nova.
Preciso configurar algo antes de começar o rastreamento de custos?
Não. O Vibes to Bucks começa a registrar seu uso do Cursor AI no momento em que é instalado — sem necessidade de conta de cobrança ou mapeamentos. A extensão utiliza padrões sensatos (intervalo de polling de 5 minutos, exibição em EUR, taxas de câmbio do BCE) e começa a preencher seu banco de dados local imediatamente. Você pode explorar o Painel de Uso imediatamente. A sincronização de cobrança com Moneybird ou Harvest é uma etapa separada que você configura quando estiver pronto. Nota: apenas os custos que ocorrem enquanto a extensão está instalada e em execução são rastreados. Não há como importar ou recuperar custos de antes da instalação.
Qual é a diferença entre os planos Free e Pro?
O plano Free oferece rastreamento completo de custos: polling contínuo do seu uso do Cursor AI, um ledger local SQLite, o Painel de Uso com gráficos, filtros, navegação por período e sparklines, e exibição em várias moedas em 30 moedas. O plano Pro (€24/ano ou €149 vitalício, com um teste gratuito de 14 dias) desbloqueia a sincronização de integração com Moneybird ou Harvest, orçamentos de custos de IA com alertas de excesso de gastos, resumos de commits gerados por IA para descrições de entradas de tempo, comandos de sincronização dry-run e backfill, e uma barra de status por janela mostrando o nome do cliente resolvido, nome do projeto e uso do orçamento semanal para o espaço de trabalho atual.
O que é o multiplicador de custo e quando devo usá-lo?
O multiplicador de custo escala o custo bruto do token de IA antes de convertê-lo em horas faturáveis. Use-o quando quiser cobrar pelo trabalho assistido por IA com uma margem de lucro — o multiplicador captura o valor real que você entrega: elaboração de prompts, revisão e iteração sobre o resultado, integração do resultado e responsabilidade pelo produto final. Um multiplicador de 5 significa que cada €1 gasto em IA se torna €5 de receita faturável. Comece com 5 e ajuste para corresponder aos seus acordos com clientes. Se você deseja apenas recuperar custos sem margem, use o modo passthrough.
Posso mapear vários clientes para o mesmo repositório?
Sim. Use um mapeamento de repositório multi-cliente com padrões de branch. Cada padrão de branch mapeia para um contato e projeto diferente no seu software de cobrança. Por exemplo, branches correspondentes a `client-a/*` podem faturar o Cliente A enquanto o branch `dev` fatura o Cliente B a uma taxa diferente. Os padrões de branch suportam correspondência exata, curinga de nível único (`client-a/*`) e curinga recursivo (`feature/**`). Se nenhum padrão de branch corresponder, o evento é tratado como não mapeado e aparece na sua visualização de Custos Não Atribuídos.
O Vibes to Bucks funciona quando estou conectado a um servidor remoto via SSH?
Sim. A extensão funciona como uma extensão de interface, o que significa que sempre é executada na sua máquina local — mesmo quando o Cursor está conectado a um host remoto via SSH. Sua pasta local `~/.vibes-to-bucks/` (banco de dados do ledger, configuração e arquivo de licença) está sempre no seu laptop, então o Painel de Uso sempre tem uma visão completa de toda a atividade, independentemente de qual espaço de trabalho remoto você está conectado. O único pré-requisito para remotos SSH é a autenticação baseada em chave sem senha para que a extensão possa executar `git log` no remoto para buscar mensagens de commit.
O Vibes to Bucks suporta agentes Cursor Cloud (desenvolvimento baseado em nuvem do Cursor)?
Não — o desenvolvimento baseado em nuvem não é suportado atualmente. O Vibes to Bucks funciona observando a atividade em suas janelas locais abertas do Cursor para atribuir custos de IA ao espaço de trabalho correto. Agentes Cursor Cloud são executados inteiramente na infraestrutura de nuvem do Cursor sem uma janela local do Cursor, então a extensão não pode observar ou atribuir esses custos. Qualquer gasto de IA gerado por agentes na nuvem aparecerá como custos não atribuídos na sua visualização de Custos Não Atribuídos. Desenvolvimento local e desenvolvimento remoto SSH são totalmente suportados.
Onde meus dados são armazenados e o Vibes to Bucks envia algo para a nuvem?
Todos os dados de custo ficam em um banco de dados local SQLite em `~/.vibes-to-bucks/ledger.db` na sua máquina. Nada é enviado para qualquer servidor do Vibes to Bucks. A extensão faz quatro conexões de saída: para a API do painel do Cursor para buscar seus eventos de uso, para a API Frankfurter (Banco Central Europeu) para obter taxas de câmbio diárias, para a API Lemon Squeezy para validar sua licença Pro (reverificação periódica, nenhum dado de uso enviado) e para seu provedor de cobrança (Moneybird ou Harvest) quando você sincroniza. Sem telemetria, sem análises, nenhum dado de custo sai da sua máquina, exceto o que vai diretamente para sua própria conta de cobrança.
O que acontece se um projeto não tiver um git remote?
Você ainda pode rastrear e cobrar custos de IA usando uma regra de mapeamento baseada em pasta. Adicione um mapeamento com um caminho de `folder` em vez de uma URL remota de `repo` — por exemplo, `/home/user/experiments`. Qualquer evento de uso do Cursor a partir dessa pasta de espaço de trabalho será associado ao cliente e projeto especificados. Mapeamentos de pasta também são úteis como uma regra abrangente para capturar custos de pastas de rascunho, repositórios em estágio inicial ou qualquer espaço de trabalho que ainda não tenha um remoto configurado.
Como o Sync Now difere do Backfill?
'Sync Now' envia horas faturáveis para seu software de cobrança para todos os dias registrados até agora. 'Backfill' permite que você sincronize um intervalo histórico específico — você escolhe uma data de corte e a extensão cria ou atualiza entradas de tempo para cada dia correspondente entre essa data e hoje. Ambos os comandos cobrem apenas custos registrados desde que a extensão foi instalada; não há como recuperar custos de antes desse ponto. Ambos os comandos são idempotentes: se uma entrada de tempo já existir para um determinado dia, cliente e projeto e os totais não tiverem mudado, a sincronização a ignora sem fazer qualquer chamada de API.
Quais moedas são suportadas e como a taxa de câmbio é obtida?
A extensão suporta todas as 30 moedas publicadas pela API Frankfurter (fonte do Banco Central Europeu), incluindo EUR, USD, GBP, CHF, JPY, CAD, AUD e mais. USD é sempre usado como base, já que os custos do Cursor são denominados em USD — para exibição em USD, nenhuma conversão é necessária. Para todas as outras moedas, as taxas diárias são obtidas da Frankfurter e armazenadas em cache localmente no SQLite. Se a API estiver inacessível, a extensão recorre ao valor `fallback_rate` na sua configuração (padrão 0,92, calibrado para EUR). Para Backfill, a extensão recupera a taxa histórica para cada dia específico do passado, para que as conversões sejam precisas, mesmo para entradas criadas há meses. A moeda de exibição padrão é EUR e pode ser alterada nas configurações da extensão.