Primeiros passos

Esta página leva você da instalação a uma skill ativada em dois agentes e uma sessão retomada, em cerca de cinco minutos.

Instalação

#

Com Go 1.26 ou mais recente:

go install github.com/rogeriojunior31/lazyagents@latest

Ou baixe um binário em Releases (Linux, macOS Intel e Apple Silicon, Windows) e confira-o usando SHA256SUMS:

tar -xzf lazyagents_<version>_linux_amd64.tar.gz
./lazyagents --version

Nenhuma outra ferramenta é obrigatória. Alguns recursos usam ferramentas que você talvez já tenha:

Confira o que o lazyagents encontra

#

lazyagents doctor

O doctor lista os agentes encontrados, valida cada skill e informa links quebrados, hooks e plugins. Um agente é considerado instalado quando seu binário está no PATH ou seu diretório de configuração existe. A matriz completa dos recursos de cada agente está na referência de suporte dos agentes.

Abra a TUI

#

lazyagents

As abas ficam no topo: tab e shift+tab alternam entre elas; 1–9 vão direto à aba correspondente (clicar também funciona). ? lista as teclas da aba atual e : abre a paleta de comandos. q sai. O painel de detalhes fica ao lado da tabela em terminais largos e abaixo dela nos estreitos; a roda do mouse rola o conteúdo e um clique seleciona.

Ative uma skill em dois agentes

#

1. Na aba Skills, pressione i e informe uma origem: um repositório do GitHub (usuario/repo ou sua URL), uma pasta local ou um .zip.
2. Se a origem tiver várias skills, escolha quais instalar; uma skill única é instalada diretamente. Elas são copiadas para sua biblioteca, ~/.local/share/lazyagents/skills/.
3. Selecione uma skill, vá até a coluna de um agente com ←/→ e pressione space. O lazyagents cria um link simbólico no diretório de skills desse agente. Pressionar space novamente remove o link.
4. a ativa a skill em todos os agentes de uma vez; x desativa em todos.

Skills que já estavam dentro de um agente também aparecem, como skills locais. o incorpora uma delas à biblioteca para que os outros agentes possam usá-la. Veja o guia de skills.

Retome uma sessão

#

1. Abra a aba Sessions. Ela lista conversas do Claude Code, Codex, Gemini CLI, OpenCode, Pi e Crush, das mais recentes para as mais antigas.
2. Digite / para filtrar ou f para mostrar apenas um agente.
3. Pressione enter: o lazyagents suspende sua interface e retoma a sessão na CLI do próprio agente, na pasta correta. Ao sair do agente, você volta ao lazyagents.

v permite ler a conversa sem retomar a sessão. Veja o guia de sessões.

Consulte seu consumo

#

A aba Usage mostra os limites da assinatura (janelas de sessão e semanais, com os horários de renovação) e o consumo de tokens das conversas locais. p altera o período e ←/→ muda a visualização. Os limites do Claude Code são consultados pela rede somente quando você abre a aba ou executa lazyagents usage ou doctor, e ficam em cache por cinco minutos. Até você entrar em um agente ou usá-lo pela primeira vez, seus limites aparecem como ainda indisponíveis: isso é esperado. Veja o guia de consumo.

Use em scripts

#

Cada aba tem uma alternativa sem interface, e os comandos de consulta aceitam --json:

lazyagents list --json                     # skills e onde estão ativadas
lazyagents enable my-skill --all           # ativar em todos os agentes
lazyagents sessions --here --limit 5       # sessões recentes nesta pasta
lazyagents usage daily --since 30d

lazyagents help <comando> explica cada comando; o mesmo texto está na referência da CLI.

Desinstalação

#

Desfaça o que o lazyagents colocou nos diretórios dos agentes antes de apagar seus dados. Caso contrário, os links das skills apontarão para uma biblioteca que não existe mais (lazyagents doctor lista links quebrados):

1. Execute lazyagents disable <skill> para cada skill ativada (lazyagents list mostra quais são). Para manter uma skill em um agente, primeiro copie sua pasta da biblioteca para o diretório de skills desse agente.
2. Execute lazyagents provider clear e lazyagents hooks disable <nome> para cada hook instalado.
3. Apague o binário, ~/.config/lazyagents e ~/.local/share/lazyagents. A pasta de backups fica dentro da última: preserve-a se houver algo que você possa querer recuperar.

Próximos passos

#

• Alterar o tema, a ordem das abas ou a aba inicial: Configuração e Temas.
• Apontar um agente para outro endpoint de API: Providers.
• Executar um comando em eventos dos agentes: Hooks.
• Entender o que o lazyagents altera no disco antes de usá-lo: Segurança e dados.