Criou vários agentes de IA e agora tá perdido? Nomes, comandos, quando usar cada um... Tenho a solução. · LucasMattos

Eu tenho 42 agentes de IA organizados em 6 squads. Criei no Claude Code, testei no Antigravity, mexi no Codex, experimentei até o OpenClaw. Cada um com um nome, comandos específicos, um propósito diferente. Agente de QA, de deploy, de arquitetura, de vendas, de automação...

Agora deixa eu te contar um detalhe: eu não sou programador. Tenho TDAH. E não falo inglês.

Todos — eu disse todos — os frameworks de agentes de IA são em inglês. Nomes em inglês, comandos em inglês, descrições em inglês. Pra alguém como eu, era uma luta diária tentando lembrar o que cada agente fazia, qual a diferença entre eles, qual comando ativava o quê. E olha que eu não tô falando só dos agentes "de fábrica" — até os meus agentes personalizados, que eu mesmo criei, eu esquecia o básico. Nome, comandos, quando usar.

E sabe o que é pior? Cada vez que eu errava um comando, pedia uma tradução, ou ficava alterando as coisas tentando lembrar melhor... isso tudo me custava tokens. E dinheiro ainda não sai da torneira. Cada tentativa errada era centavos indo embora, sem resultado nenhum.

Então eu fiz o que qualquer pessoa desesperada faria: criei um sistema de suporte pra me ajudar. Se chama agent-ajuda e é 100% gratuito.

O problema que ninguém fala

Se você usa agentes de IA no seu dia a dia, provavelmente já passou por isso:

Seus agentes estão espalhados em arquivos .md, .yaml, prompts soltos por aí
Não existe um catálogo central — pra encontrar algo, você precisa abrir arquivo por arquivo
Você cria um agente novo, usa por 3 dias, e na quarta-feira já não lembra o nome dele
Quando organiza agentes em squads ou times, não documenta quem faz o quê
Cada comando errado que você digita = tokens gastos = dinheiro perdido

E se você é iniciante, o cenário é ainda pior: você nem sabe que pode organizar seus agentes em times, com pipeline, quality gates e tudo mais. Ninguém te contou isso.

O resultado? Você tem uma coleção poderosa de agentes de IA... e usa 10% do potencial porque não consegue lembrar o que já tem disponível.

O que é o agent-ajuda

É um app desktop que lê os seus agentes de arquivos locais e mostra tudo numa interface visual, organizada, pesquisável e — o mais importante — em português.

O app tem 4 abas principais:

Agentes — Todos os seus agentes listados, com filtro por categoria (Core, Vendas, N8N, IA, Python, Conselho). Clica num agente e vê tudo: nome, ID, o que faz, quando usar, todos os comandos disponíveis.
Times — Suas squads montadas, com todos os membros e seus papéis. Precisa de um time pra projeto fullstack? Tá lá, com a composição completa.
Workflows — Os 14 fluxos de trabalho com timeline visual de fases. Você vê quem faz o quê em cada etapa.
Referência — Pipeline de 5 fases, 4 quality gates, checklists, constituição do framework. Tudo num lugar só.

E a feature que mais me salva no dia a dia: click-to-copy. Clicou no nome do agente? Copiou o ID. Clicou num comando? Copiou o comando. É só colar direto no chat da sua IA e usar. Sem digitar nada, sem errar, sem gastar token à toa.

O app roda 100% offline, tem só 2 dependências (CustomTkinter e PyYAML), abre em menos de 3 segundos e nasceu da necessidade real de alguém com TDAH que não podia se dar ao luxo de ficar desperdiçando tokens tentando lembrar o nome dos próprios agentes.

Como funciona na prática

Vou te dar cenários reais do meu dia a dia:

"Qual agente eu uso pra fazer code review?"
Abro o app → digito "review" na busca → aparece o @qa (Quinn) → clico no comando *code-review → copiou → colo no chat do Claude Code → pronto.

"Preciso montar um time pra um projeto fullstack"
Vou na aba Times → encontro "Time Fullstack" → vejo que tem: Morgan (PM), River (Scrum Master), Aria (Arquiteta), Dex (Dev), Quinn (QA) e Gage (DevOps) → sei exatamente quem chamar.

"Como funciona o pipeline de desenvolvimento?"
Aba Referência → Pipeline → 5 fases visuais: Planejar → Especificar → Implementar → Testar → Validar. Cada fase mostra qual agente é responsável e o que ele entrega.

"Acabei de criar um agente novo"
Aperto F5 → o app relê todos os arquivos → meu agente novo aparece na lista. Sem reiniciar nada.

Tudo isso sem abrir terminal, sem navegar em pastas, sem ler arquivos em inglês. É buscar, clicar, copiar e usar.

Pra quem é isso?

Se você é iniciante: o agent-ajuda é uma interface visual onde você descobre o que cada agente faz, quando usar, quais comandos existem — sem precisar ler dezenas de arquivos em inglês. É tipo um manual interativo dos seus agentes.

Se você é avançado: é uma referência rápida. Catálogo pesquisável, click-to-copy, atalhos de teclado (Ctrl+F pra buscar, F5 pra recarregar). Você não precisa dele pra funcionar, mas ele te poupa tempo todo dia.

Se você tem TDAH, não fala inglês, ou simplesmente não consegue manter 42 nomes de agentes na cabeça: esse app foi literalmente feito pra você. Porque foi feito por alguém que tem exatamente esses problemas.

Como instalar

Tem duas formas:

Forma 1: Via terminal

git clone https://github.com/Gsesportes/agent-ajuda
cd agent-ajuda
pip install -e .
aiox-ajuda

Precisa ter Python 3.12+ instalado. No Windows, depois de instalado, você pode dar double-click no arquivo run.pyw pra abrir sem terminal.

Forma 2: Pedindo pra sua IA (recomendado pra quem não é dev)

Abre o chat da sua IA preferida (Claude Code, Cursor, Copilot, qualquer uma) e manda:

"Clone o repositório https://github.com/Gsesportes/agent-ajuda, instale as dependências e rode o app pra mim"

A IA faz tudo por você. Sério. Clone, instalação, execução — tudo no automático.

Um detalhe importante: as configurações do app (caminhos dos agentes, tema, etc.) por enquanto só estão disponíveis via IA. Como eu não sou programador, não encontrei uma forma de automatizar isso via script — então a IA configura pra você. Basta pedir algo como "configure o agent-ajuda pra usar meus agentes da pasta X". Simples assim.

Pra fechar

Esse projeto não foi feito por uma empresa. Foi feito por um cara com TDAH, que não fala inglês e não é programador, usando IA pra resolver um problema que a IA mesma criou: agentes demais, memória de menos.

Se você, assim como eu, cria agentes e depois se perde neles — o agent-ajuda existe pra isso. É MIT, é gratuito, e contribuições são super bem-vindas — especialmente de programadores que queiram melhorar o que um leigo em programação começou.

Se curtiu a ideia, uma estrela no GitHub ajuda o projeto a chegar em mais gente que precisa: github.com/Gsesportes/agent-ajuda