- O que acontece aos meus dados de custos rastreados quando elimino uma regra de faturação?
- Os seus dados de custos são sempre preservados. Eliminar uma regra de faturação apenas remove a regra em si — nunca afeta o seu histórico de custos rastreados. Os custos que anteriormente estavam associados a essa regra simplesmente ficam sem atribuição e reaparecem na sua vista de Custos Não Atribuídos na próxima vez que abrir o painel. A partir daí, pode reatribui-los a um projeto ou cliente diferente a qualquer momento.
- Se reatribuir custos a um projeto diferente após eliminar uma regra de faturação, a reatribuição aplica-se também a custos passados?
- Sim — a reatribuição aplica-se retroativamente a todos os custos registados desde que a extensão foi instalada. Os seus eventos de custo brutos são armazenados permanentemente na base de dados local e nunca estão ligados a uma regra de faturação específica. Quando adiciona uma nova atribuição, o motor de sincronização compara-a com todo o seu histórico registado. Na próxima vez que executar Sincronizar Agora ou Preencher Retroativamente, as entradas de tempo são criadas ou atualizadas no seu software de faturação para cada dia correspondente no passado, incluindo dias que anteriormente não estavam atribuídos. Nada se perde entre o momento em que elimina uma regra e o momento em que cria uma nova.
- Preciso de configurar algo antes de começar o rastreamento de custos?
- Não. O Vibes to Bucks começa a registar o uso do Cursor AI no momento em que é instalado — não é necessária conta de faturação ou mapeamentos. A extensão utiliza valores padrão sensatos (intervalo de sondagem de 5 minutos, exibição em EUR, taxas de câmbio do BCE) e começa a preencher a sua base de dados local imediatamente. Pode explorar o Painel de Utilização de imediato. A sincronização de faturação para Moneybird ou Harvest é um passo separado que 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á forma de importar ou recuperar custos anteriores à instalação.
- Qual é a diferença entre os planos Gratuito e Pro?
- O plano Gratuito oferece rastreamento completo de custos: sondagem contínua do uso do Cursor AI, um livro-razão local SQLite, o Painel de Utilização com gráficos, filtros, navegação por períodos e mini-gráficos, 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 compromissos gerados por IA para descrições de entradas de tempo, comandos de sincronização de teste e preenchimento retroativo, e uma barra de estado por janela que mostra 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 custos e quando devo usá-lo?
- O multiplicador de custos escala o seu custo bruto de tokens de IA antes de convertê-lo em horas faturáveis. Use-o quando quiser faturar trabalho assistido por IA com uma margem de lucro — o multiplicador captura o valor real que entrega: criaçã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 de gasto em IA se torna €5 de receita faturável. Comece em 5 e ajuste para corresponder aos acordos com os seus clientes. Se apenas quiser recuperar custos sem margem, use o modo de passagem direta.
- Posso mapear vários clientes para o mesmo repositório?
- Sim. Use um mapeamento de repositório multi-cliente com padrões de ramificação. Cada padrão de ramificação mapeia para um contacto e projeto diferentes no seu software de faturação. Por exemplo, ramificações que correspondem a `client-a/*` podem faturar o Cliente A enquanto a ramificação `dev` fatura o Cliente B a uma taxa diferente. Os padrões de ramificação suportam correspondência exata, wildcard de nível único (`client-a/*`) e wildcard recursivo (`feature/**`). Se nenhum padrão de ramificação corresponder, o evento é tratado como não mapeado e aparece na sua vista 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 do utilizador, o que significa que é sempre executada na sua máquina local — mesmo quando o Cursor está conectado a um host remoto via SSH. A sua pasta local `~/.vibes-to-bucks/` (base de dados do livro-razão, configuração e ficheiro de licença) está sempre no seu portátil, por isso o Painel de Utilização tem sempre uma visão completa de toda a atividade, independentemente de qual espaço de trabalho remoto está conectado. O único pré-requisito para remotos SSH é a autenticação por chave sem senha para que a extensão possa executar `git log` no remoto para obter mensagens de commit.
- O Vibes to Bucks suporta agentes Cursor Cloud (desenvolvimento baseado na nuvem do Cursor)?
- Não — o desenvolvimento baseado na nuvem não é atualmente suportado. O Vibes to Bucks funciona observando a atividade nas suas janelas locais abertas do Cursor para atribuir custos de IA ao espaço de trabalho correto. Os agentes Cursor Cloud funcionam inteiramente na infraestrutura de nuvem do Cursor sem uma janela local do Cursor, por isso 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 vista de Custos Não Atribuídos. O desenvolvimento local e o desenvolvimento remoto SSH são totalmente suportados.
- Onde estão armazenados os meus dados e o Vibes to Bucks envia alguma coisa para a nuvem?
- Todos os dados de custos residem numa base 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 obter os 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 a sua licença Pro (verificação periódica, sem envio de dados de uso), e para o seu fornecedor de faturação (Moneybird ou Harvest) quando sincroniza. Sem telemetria, sem análises, nenhum dado de custo sai da sua máquina exceto o que vai diretamente para a sua própria conta de faturação.
- O que acontece se um projeto não tiver um repositório git remoto?
- Ainda pode rastrear e faturar custos de IA para ele usando uma regra de mapeamento baseada em pasta. Adicione um mapeamento com um caminho `folder` em vez de um URL remoto `repo` — por exemplo, `/home/user/experiments`. Quaisquer eventos de uso do Cursor dessa pasta de espaço de trabalho serão associados ao cliente e projeto especificados. Os mapeamentos de pasta também são úteis como uma regra abrangente para capturar custos de pastas de rascunho, repositórios em fase inicial ou qualquer espaço de trabalho que ainda não tenha um remoto configurado.
- Como é que o Sincronizar Agora difere do Preencher Retroativamente?
- 'Sincronizar Agora' envia horas faturáveis para o seu software de faturação para todos os dias registados até agora. 'Preencher Retroativamente' permite sincronizar um intervalo histórico específico — 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 apenas cobrem custos registados desde que a extensão foi instalada; não há forma de recuperar custos anteriores a esse ponto. Ambos os comandos são idempotentes: se já existir uma entrada de tempo para um determinado dia, cliente e projeto e os totais não tiverem mudado, a sincronização ignora-a sem fazer qualquer chamada à API.
- Quais são as moedas suportadas e como é obtida a taxa de câmbio?
- 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. O USD é sempre usado como base, uma vez que os custos do Cursor são denominados em USD — para exibição em USD não é necessária conversão. Para todas as outras moedas, as taxas diárias são obtidas da Frankfurter e armazenadas localmente em cache 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 o Preencher Retroativamente, a extensão recupera a taxa histórica para cada dia específico no passado, para que as conversões sejam precisas mesmo para entradas criadas há meses. A moeda de exibição padrão é o EUR e pode ser alterada nas definições da extensão.