followup-cli

CLI para controle de follow-up de demandas pendentes com clientes. Ideal para agencias, studios e freelancers que precisam cobrar briefings, acessos, validacoes e outras entregas.

Dois modos de uso: comandos diretos para acoes rapidas e dashboard interativo para visao geral.

Instalacao

npm install -g followup-cli

Zero dependencias nativas — roda em qualquer maquina com Node.js.

Resumo rapido

Rode followup sem argumentos para ver o status geral:

followup v1.1.0

  3 pendentes | 1 sem cobranca ha 5 dias  | 2 cobrados

  Mais atrasados:
  #3  Empresa X     Briefing site         5 dias  | 3x cobrado
  #7  Empresa W     Acessos hospedagem    4 dias  | 0x cobrado

  followup --help para ver comandos

Uso

Clientes

followup cliente add "Empresa X" --whatsapp "11999999999"
followup cliente list
followup cliente edit 1 --nome "Novo Nome"
followup cliente rm 1

Follow-ups

# Criar
followup add "Empresa X" --tipo briefing --descricao "site institucional" --urgencia alta

# Listar
followup list
followup list --cliente "Empresa X"
followup list --urgencia alta
followup list --atrasados 7

# Cobrar (mostra link do WhatsApp automaticamente)
followup cobrar 1 --nota "mandei whatsapp"
# -> https://wa.me/5511999999999

# Historico
followup historico 1

# Concluir
followup done 1 --nota "cliente entregou o briefing"

# Editar / Remover
followup edit 1 --urgencia alta
followup rm 1

# Ver tudo (incluindo concluidos)
followup list --todos

Templates

Crie templates reutilizaveis para tipos de projeto recorrentes:

# Criar template com itens
followup template create "site" --items briefing,acessos,hospedagem,validacao

# Criar template interativamente
followup template create "site" -i

# Listar e ver detalhes
followup template list
followup template show "site"

# Aplicar template a um cliente (cria todos os follow-ups de uma vez)
followup template apply "site" "Empresa X"
followup template apply "site" "Empresa X" --urgencia alta

# Remover
followup template rm "site"

Templates ficam em ~/.followup/templates.json — edite direto se preferir.

Tipos de follow-up

Tipos padrao: briefing, acessos, hospedagem, validacao, conteudo

followup tipos
followup tipos add "contrato" --descricao "Contrato assinado"

Dashboard

followup dashboard

Dashboard interativo no terminal:

• Itens agrupados por urgencia (alta/media/baixa)
• Navegacao por setas
• Add, Cobrar, Done, Historico, Filtro, Quit
• Destaque para itens esquecidos (sem cobranca ha mais de 2 dias)
• Link do WhatsApp ao cobrar

Relatorio

# Terminal colorido (ultimos 7 dias)
followup relatorio

# Periodo customizado
followup relatorio --dias 30

# Markdown (para colar no Slack, Notion, etc.)
followup relatorio --md

Como funciona

• Dados ficam em ~/.followup/data.db (SQLite local via WASM)
• Templates ficam em ~/.followup/templates.json
• Zero config — na primeira execucao cria tudo automaticamente
• Cada follow-up rastreia: cliente, tipo, descricao, urgencia, status e historico completo de cobrancas

Stack

TypeScript, Commander.js, Ink, Drizzle ORM, sql.js

Licenca

MIT