visor chama a API pessoal por você. Ela se autentica com o seu token pessoal, troca nomes por IDs, percorre as páginas e espera os limites de requisição. Cada operação desta documentação tem um comando. O código está no GitHub.
Instale
visor --version. O autocompletar do shell está disponível com visor completions zsh, e também bash, fish e powershell.
Atualize
visor update roda brew upgrade visor-finance/tap/visor numa instalação pelo Homebrew, ou o instalador da nova versão na mesma pasta nas instalações pelos instaladores de shell e PowerShell. Se o Homebrew ou o instalador falhar, o erro deles fica na tela e a CLI continua como estava.
Desde a 0.7.0 a CLI também se atualiza sozinha. No terminal, depois de um comando, ela instala uma versão de patch mais nova em segundo plano (a saída vai para update.log na pasta de configuração). Uma versão minor ou major nova, ou mais de cinco patches à frente, é instalada antes do comando, que então roda na versão nova. Uma atualização que falha nunca interrompe o comando, e a CLI espera uma hora antes de tentar de novo. Só as instalações pelo Homebrew e pelos instaladores se atualizam; CI, pipes e saída --json nunca mostram uma atualização.
Sem navegador
Em um servidor ou na CI, crie um token pessoal em Configurações > Apps Conectados e entregue à CLI:VISOR_TOKEN tem prioridade sobre o login guardado. Veja Autenticação.
Comandos do dia a dia
- Contas, categorias, tags e espaços aceitam um nome ou um ID. Uma categoria do sistema também aceita a chave sem o prefixo
category., comofood_and_drinks. --spaceescolhe o espaço de um comando. Sem ele, a CLI usa o espaço devisor spaces usee, depois, o seu espaço pessoal padrão.- Valores são decimais positivos, como
42.90ou42,90.--type debit, o padrão, registra uma saída;--type creditregistra uma entrada. visor tx addenvia umIdempotency-Keye mostra o valor. Rode o comando de novo com--idempotency-keye essa chave para tentar outra vez sem registrar duas vezes. Veja Idempotência.
visor --help, ou --help depois de qualquer comando, para ver todas as opções.
Envie um Pix
visor pix inicia um Pix e mostra a página em que você o confirma com biometria no seu banco; nada é pago antes disso. No terminal, a CLI pergunta onde você vai confirmar: neste computador (ela abre a página) ou no celular (ela mostra a página como QR code). O primeiro Pix de um banco vincula o banco antes. Depois a CLI espera até o Pix ser pago e mostra o ID end-to-end, ou falha com o código de saída 5 quando o Pix falha, é cancelado ou expira. Ctrl+C para de esperar, não cancela o Pix.
- O Pix precisa do plano Pro (10 Pix por mês) ou Premium (30) e do login pelo navegador. Na primeira vez,
visor pixabre o navegador para você autorizar o Pix e troca o login guardado pelo novo. Um token pessoal ou oVISOR_TOKENnão inicia Pix. - Sem
--bank, o Visor usa o único banco que você já vinculou. Senão, no terminal, a CLI pergunta qual banco; num script, o erro lista os bancos que você pode passar em--bank. Uma chave que pode ser CPF ou celular funciona do mesmo jeito, com--key-type cpfou--key-type phone. - O vínculo com o banco fica no aparelho que o criou. Para confirmar em outro aparelho (a página do banco diz “Dispositivo não reconhecido”), passe
--link-device: esse aparelho vincula o banco antes e depois confirma.
Scripts
--json imprime o corpo da resposta da API sem mudanças, então os campos são os da referência da API. Os dados vão para a saída padrão; avisos e erros vão para a saída de erro.
--limit resultados (50 por padrão) e busca as páginas de que precisa. --all segue cada next_cursor, e --after continua a partir de um cursor. A CLI espera o retry-after em um 429 e tenta de novo respostas 5xx, dentro dos limites de requisição.