Terminal moderno para o SUAP do IFRN. Veja suas aulas, frequência, notas e notificações direto no terminal — sem abrir o navegador.
____ _ _ ____ _ ____ ___
/ ___|| | | | _ \ / \ / ___/ _ \
\___ \| | | | |_) / _ \| | | | | |
___) | |_| | __/ ___ \ |__| |_| |
|____/ \___/|_| /_/ \_\____\___/
CLI do SUAP · IFRN
⚠️ Projeto não oficial. Desenvolvido pela comunidade, sem vínculo com o IFRN.
| Tela | O que mostra |
|---|---|
| 📅 Aulas de Hoje | Horário, sala e professor das aulas do dia. Indicador de frequência em tempo real. |
| 📆 Grade da Semana | Visão semanal completa com todos os horários. |
| 📊 Frequência e Faltas | Quantas faltas você tem e quantas ainda pode dar por disciplina. |
| 📝 Notas do Semestre | Notas por etapa e médias parciais/finais. |
| 👤 Meu Perfil | Dados acadêmicos, IRA e progresso de conclusão do curso. |
| 🔔 Notificações | Mensagens não lidas enviadas pelo SUAP. |
yay -S supaco-cligo install github.com/kellyson71/supaco-cli@latestPré-requisitos: Go 1.21+
git clone https://github.com/kellyson71/supaco-cli.git
cd supaco-cli
go build -o supaco .
# Instalar globalmente (Linux/macOS)
sudo mv supaco /usr/local/bin/git clone https://github.com/kellyson71/supaco-cli.git
cd supaco-cli
go build -o supaco .
cp supaco ~/.local/bin/supaco # ou /usr/local/bin/ com sudocp completions/supaco.fish ~/.config/fish/completions/Depois é só digitar supaco + Tab para ver os comandos disponíveis.
supaco # abre o painel interativo (TUI)
supaco hoje # aulas de hoje
supaco semana # grade da semana
supaco faltas # frequência e limite de faltas por disciplina
supaco notas # notas do semestre
supaco status # resumo rápido (IRA, hoje, alertas)
supaco help # ajudaNa primeira execução, uma tela de login aparece. Digite sua matrícula e senha do SUAP.
Os tokens são salvos em ~/.config/supaco/config.json (modo 600) — você não precisará fazer login novamente até o token expirar.
| Tecla | Ação |
|---|---|
↑ / k |
Subir no menu |
↓ / j |
Descer no menu |
Enter |
Selecionar / Confirmar |
Esc / q |
Voltar / Fechar |
r |
Atualizar dados do SUAP |
Ctrl+C |
Sair |
O SUPACO usa a API JWT do SUAP:
- Login →
POST /api/token/paircom matrícula e senha - Token refresh → automático ao receber
401 Unauthorized - Dados carregados em sequência:
/api/ensino/meus-dados-aluno/— perfil e IRA/api/ensino/meus-periodos-letivos/— semestres cursados/api/ensino/diarios/{semestre}/— aulas, faltas e notas/api/ensino/requisitos-conclusao/— progresso do curso/api/edu/mensagens/entrada/nao_lidas/— notificações
Para gerar o GIF de demonstração incluso no README:
# 1. Instale o ttyd (necessário pelo VHS)
# Arch: yay -S ttyd
# Ubuntu: snap install ttyd --classic
# macOS: brew install tsl0922/tools/ttyd
# 2. Instale o VHS
go install github.com/charmbracelet/vhs@latest
# 3. Rode o tape
vhs demo.tape
# Gera assets/demo.gif e assets/demo.mp4Para screenshots manuais no Linux:
# Script incluso (usa grim + slurp no Wayland)
./scripts/screenshot.sh login # salva assets/login.png
./scripts/screenshot.sh menu # salva assets/menu.png
./scripts/screenshot.sh hoje # salva assets/hoje.png
# Ou manualmente:
# Wayland (Hyprland/Sway/KDE Wayland)
grim -g "$(slurp)" assets/screenshot.png
# Flameshot
flameshot gui -p assets/
# GNOME
gnome-screenshot -a -f assets/screenshot.png
# KDE Spectacle
spectacle -r -b -o assets/screenshot.pngsupaco-cli/
├── main.go # Entry point
├── demo.tape # VHS tape para gerar GIF
├── assets/ # Screenshots e GIFs
└── internal/
├── api/
│ ├── client.go # HTTP client + auth
│ └── models.go # Structs da API do SUAP
├── config/
│ └── config.go # Persistência de tokens
└── ui/
├── app.go # App principal (Bubble Tea)
├── login.go # Tela de login
├── views.go # Telas de conteúdo
└── styles.go # Estilos (Lip Gloss)
- Bubble Tea — framework TUI (Elm architecture)
- Lip Gloss — estilização de terminal
- Bubbles — componentes (textinput, viewport, spinner)