O painel do projeto
Mods
Um mod é um plugin pequeno que muda o próprio agente de programação: o que aparece na tela (um painel ao lado, uma faixa acima de onde você digita, um item na linha de status, um aviso rápido) ou o que acontece (barrar um comando perigoso, mudar um pedido antes de ele chegar, um comando novo com barra). Mods funcionam só no Claude Code: o Codex não deixa um plugin mudar a tela nem o jeito de trabalhar dele.
A barra de status do Faundr é configuração; um mod é código que roda dentro do agente e reage ao que está acontecendo.
O mod do Faundr
O Faundr tem um mod pronto, o faundr-mod:
- avisa, uma vez cada, quando o contexto da conversa ou um limite de uso (5 horas, semana) passa de 80% e de 95%;
- com Faixa acima do prompt ligada no painel (Configurações → Barra de status), mostra as barras logo acima de onde você digita.
Para instalar, digite no agente:
/plugin install faundr-mod@faundr
Ele lê as mesmas escolhas da aba Barra de status do painel.
Criar o seu
Peça ao agente com /faundr:mod e diga o que quer ver ou o que deve acontecer:
/faundr:mod um aviso quando eu ficar mais de 30 minutos sem rodar os testes
O agente segue um roteiro com as melhores práticas:
- Carrega o guia oficial de plugins, que diz a API exata da versão que você usa (ela muda entre versões).
- Confere se é mesmo um mod: às vezes uma regra, um workflow ou um item da barra resolve com menos.
- Pergunta só o que falta: o que aparece e quando, onde (terminal, app, VS Code) e o que você pode ligar e desligar.
- Registra no Faundr como funcionalidade, com os passos.
- Escreve com cuidado: a lógica separada da tela (para dar para testar), o estado guardado no lugar certo, sem atrapalhar os outros plugins, funcionando em terminal estreito e em mais de uma tela.
- Verifica antes de dizer que ficou pronto: valida, checa os tipos e roda os testes.
- Entrega: diz como ver funcionando e oferece guardar o mod numa pasta sua.
Enquanto o agente escreve, ele pergunta uma vez se pode recarregar ao vivo nesta sessão. Com sim, o mod aparece assim que a resposta termina, e cada mudança recarrega sozinha. Com não, ele carrega na próxima sessão.
Comandos
| Comando | Onde | O que faz |
|---|---|---|
/faundr:mod [o que o mod faz] | agente | Cria ou ajusta um mod seguindo o roteiro acima. |
/plugin | agente | Lista os plugins e mods instalados; liga, desliga, atualiza e remove. |
/plugin install <mod> --marketplace <dono>/<repositório> | agente | Instala um mod de um repositório do GitHub. |
/reload-plugins | agente | Relê os plugins e mods sem reiniciar. |
claude plugin validate <pasta> | terminal | Confere o mod como o agente vai ler: o que ele liga, o que chama e o que seria recusado. |
claude plugin test <pasta> | terminal | Roda os testes do mod (*.test.ts). |
claude --plugin-dir <pasta> | terminal | Abre uma sessão com o mod carregado direto da pasta, para testar. |
claude --debug | terminal | Abre uma sessão que registra por que um mod não carregou ou um hook foi pulado. |
Quando algo não funciona
- O mod não aparece: rode
/plugine veja se ele está ligado; depois/reload-plugins. - Aparece uma linha apagada com o nome do mod e "refused": o agente recusou o que o mod desenhou ou respondeu. O motivo está na própria linha; peça ao agente para corrigir com
/faundr:mod. - Nada acontece e não há aviso: abra com
claude --debug; o motivo fica no registro.