diego-rapoport/estudo-tui

Duas peças que trabalham juntas:
skill/professor/: skill do Claude Code que faz papel de professor particular. Ela
diagnostica o que você sabe, monta uma trilha, escreve notas em Markdown (compatíveis com
o Obsidian), passa exercícios com repetição espaçada e dispara pesquisas.
estudando: painel no terminal (Rust + ratatui) que lê essas notas e mostra progresso,
revisões, exercícios, pendências e o que estudar a seguir. Ele só lê; quem escreve é a
skill (ou você, pelo editor).
## Instalar
Requer Rust (cargo) e, para a skill, Python 3 e o Claude Code. A sessão com painéis
(estudando --sessao) usa o tmux.
sh
./instalar.sh # TUI + skill + pergunta onde guardar os estudos
./instalar.sh --sem-skill # só a TUI
O script:
1. roda cargo install --path . --locked (binário em ~/.cargo/bin/estudando);
2. cria o link ~/.claude/skills/professor -> /skill/professor, para que editar a
skill no repositório já valha no Claude Code;
3. pergunta onde guardar os estudos, se isso ainda não estiver configurado.
Depois de mudar o código, rode ./instalar.sh de novo.
## Onde ficam os estudos
A skill e a TUI usam a mesma pasta base, resolvida nesta ordem:
1. $ESTUDANDODIR, se estiver definida;
2. pasta = "..." em ~/.config/estudando/config.toml (respeita $XDGCONFIGHOME).
Se nenhuma das duas existir, nada é criado às cegas. A skill pergunta onde guardar na
primeira sessão e grava a resposta. A TUI mostra como configurar. A sugestão é
/Aprendizado, que vira ~/Documentos/Aprendizado ou
~/Documents/Aprendizado conforme o idioma.
sh
estudando --pasta # qual pasta está em uso e de onde veio
estudando --definir-pasta ~/Estudos # grava (e cria) a pasta
python3 skill/professor/scripts/arvore.py base [--definir CAMINHO] # o mesmo, pelo lado da skill
Dentro da pasta base fica uma pasta por assunto (calculo/, com mapa.md, perfil.md,
conceitos/, exercicios/, pesquisa/). Ela pode ser aberta como vault do Obsidian.
O professor cronometra cada sessão, etapa a etapa, em sessoes.md e gera
progresso.md, com gráficos mermaid do tempo por semana, por sessão, por etapa e por
tópico, comparados com a meta do perfil.md. Abra no Obsidian para ver os gráficos.
## Usar
sh
estudando # abre o primeiro assunto
estudando calculo # abre direto num assunto (nome da pasta ou prefixo)
estudando --dir ~/outra/pasta # outra pasta só nesta execução
Para começar um assunto, peça ao Claude Code: "quero aprender cálculo". A skill professor
assume a partir daí.
| Aba | O que mostra |
| 1 Trilha | o mapa.md na ordem, com nível e situação da revisão de cada conceito; detalhes do selecionado; "O que estudar agora" |
| 2 Revisões | todos os conceitos ordenados por urgência (vencidas, hoje, futuras, sem data) e o histórico de revisões |
| 3 Exercícios | as listas de exercicios/, com status, questões respondidas no arquivo e conceitos cobertos |
| 4 Pendências | revisões vencidas, listas pendentes, equívocos do diagnóstico, perguntas do professor, dúvidas abertas, base frágil, seções suas em branco |
| 5 Pesquisa | os relatórios de pesquisa/ (pesquisador e atualizações), com as seções de cada um |
| 6 Perfil | o perfil.md (objetivo, diagnóstico, diário) |
| 7 Referências | o referencias.md |