Agenda Bar

Veja no rodapé do VS Code o que você está fazendo agora, quanto tempo falta e quanto tempo livre sobra no dia, usando o seu Google Agenda. Quando terminar uma tarefa, a extensão compara o tempo estimado com o real e mostra se você está ficando mais rápido.

O que ela faz

• Rodapé: compromisso ou tarefa atual com barra de progresso e tempo restante; "Dia: N tarefas · X livres"; uso do plano Claude (opcional).
• Avisos: evento 60 min antes; tarefa 10 min antes e 10 min antes do fim.
• Painel do dia (clique em "Dia: …"): linha do tempo com eventos à esquerda e tarefas à direita, botões Iniciar e Concluí, tempo ganho no dia.
• Histórico: estimado × real dos últimos 14 dias, tendência e tarefas por 1% do plano.

Como ela separa evento de tarefa

Pelo aviso do evento no Google Agenda: aviso de 10 minutos = tarefa; qualquer aviso maior (por exemplo 60 minutos) = evento. Blocos de 12 h ou mais (períodos de vários dias) são ignorados. O dia útil termina às 23h, no horário de Brasília.

Como começar (2 minutos)

1. Instale a extensão (aba de extensões do VS Code → pesquise "Agenda Bar" → Instalar).
2. Clique em "Agenda: configurar o link", no rodapé do VS Code (a barra azul de baixo, no canto esquerdo; o item aparece em amarelo). Também aparece um aviso no canto da tela com o botão "Configurar agora".
3. Escolha "Abrir o Google Agenda". Abre a página de configurações. Lá: clique na sua agenda (lista da esquerda, em "Configurações das minhas agendas") → role até "Integrar agenda" → ao lado de "Endereço secreto no formato iCal", clique no ícone de copiar.
4. Volte ao VS Code e clique de novo em "Agenda: configurar o link". A extensão encontra o link copiado e pergunta "Usar este link?" → Usar este link. Pronto.

O link é secreto: quem o tiver lê a sua agenda. Fica salvo só no seu computador, em ~/.config/agenda-bar/ical-url, com acesso restrito. Se um dia quiser trocá-lo, use o menu da barra → "Trocar o link da agenda".

Sem o link, o resto continua funcionando: os tokens e as barras do plano do Claude Code aparecem mesmo sem conectar a agenda (precisam só do Claude Code instalado). O que depende do link é a parte de compromissos, tarefas e avisos.

A agenda é lida a cada 5 minutos. A extensão só lê a agenda; nunca altera nada nela.

Tokens do Claude Code (opcional, automático)

Se você usa o Claude Code, o rodapé mostra em tempo quase real: "Tokens: pedido X · hoje Y · sem Z" (último pedido, hoje e últimos 7 dias). Passe o mouse para ver o detalhe (entrada, saída, cache). O painel mostra os mesmos números e, no Histórico, os tokens por dia e por tarefa concluída.

• A extensão lê apenas os números de uso dos registros locais do Claude Code (~/.claude/projects). Nunca lê o texto das conversas e não envia nada a lugar nenhum.
• "Gastos" = entrada + saída + cache criado. O cache lido é muito grande e barato, por isso aparece à parte.
• Os números valem para este computador. Se você tem várias conversas abertas, "pedido" é o da conversa que trabalhou por último.
• Sem o Claude Code instalado, o item simplesmente não aparece.

Porcentagem do plano: quanto já gastou e quanto falta

O rodapé mostra duas barras: Plano: 5h ┃████░░░░░░ 40% (teto 9%) · sem ██┃█░░░░░░░ 26% (ideal 16%).

O objetivo é simples: ver quanto você já gastou, quanto ainda pode gastar e quanto precisa economizar para a semana não acabar antes de renovar.

• Barra da semana (sem): o traço ┃ e o (ideal N%) mostram onde você deveria estar agora se gastasse o plano de forma uniforme nos 7 dias. Se o gasto passa do traço, você está acima do ritmo.

  • Amarela se, mantendo o ritmo atual, a semana fecharia em 85% ou mais; vermelha em 100% ou mais. Exemplo: 30% no primeiro dia projeta 210%: vermelha.

• Barra da janela de 5 h (5h): o traço ┃ e o (teto N%) mostram quanto desta janela ainda pode estar gasto ao fim dela para a semana voltar ao ritmo ideal. Se você já está acima do ritmo da semana, o teto cai, e pode chegar a 0% (não gastar). O teto é uma estimativa (converte pontos da semana em pontos da janela); passa a ser medido quando há dados suficientes.

  • Amarela perto do teto, vermelha acima dele (ou a partir de 70% / 90% da janela).

• Detalhe (passe o mouse): quanto gastou, quanto falta, quando renova, quantos pontos acima ou abaixo do ritmo, onde a semana fecharia e quanto pode gastar por dia para fechar em 100%. O painel (aba Hoje) mostra as mesmas barras maiores, com ▼ no ideal.

• Avisos: ao passar de 80% e de 95%, e uma vez por dia quando o ritmo da semana passa de 100%.

• Vem do comando /usage do próprio Claude Code, consultado a cada 5 minutos. Ele é local e não gasta tokens; a extensão não lê as suas credenciais.

• Precisa do Claude Code instalado (comando claude). Sem ele, as barras não aparecem.

• O valor é o do seu plano inteiro (todos os computadores e conversas), não só deste computador.

Como as barras do plano são calculadas

Pense no plano da semana como um dinheiro que precisa durar 7 dias: com R$ 700, o normal é gastar R$ 100 por dia. Quem gasta R$ 210 no primeiro dia fica sem antes do fim. A extensão faz essa conta com a porcentagem do seu plano.

Exemplo usado abaixo: a semana renova daqui a 4 dias (já passaram 3 dos 7) e você gastou 60% do plano.

Em palavras: o ideal diz onde você deveria estar; a projeção diz onde vai chegar se continuar assim; o "por dia" diz o freio necessário para fechar a semana em 100%. A projeção só é calculada depois que 5% da semana passou, porque no começo ela oscila muito.

Cor da barra da semana: vermelha se a projeção for 100% ou mais; amarela se for 85% ou mais. Além disso, amarela a partir de 70% gastos e vermelha a partir de 90%, qualquer que seja o ritmo.

Teto da janela de 5 h (traço ┃ da barra 5h): responde "quanto desta janela ainda posso gastar sem atrasar a semana?".

teto = gasto da janela + k × (ideal ao fim da janela − gasto da semana), limitado entre 0% e 100%.

• A parte entre parênteses é quanto da semana ainda "cabe". Se você já passou do ideal, ela é negativa: nada cabe, e o teto pode chegar a 0% ("não gaste agora").
• k converte pontos da semana em pontos da janela ("1% da semana vale quantos % de uma janela de 5 h?"). A extensão o mede pelas consultas, somando quanto a semana e a janela subiram juntas. Enquanto há poucos dados, ela o estima pelos tokens: (tokens por 1% da semana) ÷ (tokens por 1% da janela). O detalhe da barra diz se o valor é medido ou estimado.
• Exemplo: janela em 50%, k = 5, ideal ao fim da janela 44%, semana em 60%: teto = 50 + 5 × (44 − 60) = −30, que vira 0%.

Cor da barra de 5 h: vermelha se o gasto passou do teto; amarela se chegou a 85% do teto; além do piso de 70% e 90% da janela.

Avisos: notificação ao passar de 80% e de 95% (em cada janela e na semana) e, uma vez por dia, quando a projeção da semana passa de 100%.

Importante: as contas miram 100% exato. Seguir o traço à risca leva a semana a terminar sem nenhuma sobra. O amarelo (85% de projeção) e os avisos de 80% e 95% são alertas antecipados, não uma reserva. Se quiser uma margem, use como meta um valor abaixo do ideal.

Usar em dois computadores (opcional)

Com o rclone configurado, crie o arquivo ~/.config/agenda-bar/remote com uma linha, por exemplo meudrive:Agenda-Bar. O registro de "Concluí" e o uso do plano passam a ser sincronizados entre os computadores. Sem esse arquivo, tudo fica local.

Seus dados

Ficam em ~/.config/agenda-bar/ (no Windows, C:\Users\você\.config\agenda-bar\): o link, uma cópia da agenda e o registro de "Concluí". A extensão não envia nada a nenhum servidor além do próprio Google Agenda (para ler o link) e, se você ativar, o seu rclone.

Requisitos

VS Code 1.90 ou mais novo. Funciona em Linux, Windows e macOS.