Como o loop funciona
- Você fornece as tarefas (texto inline, UUID de nota existente ou retomada)
- Uma nota verde fixada é criada com caixas de seleção
- O Claude começa a executar a primeira tarefa
- O hook Stop intercepta a saída do Claude e carrega a próxima tarefa
- Cada tarefa concluída é marcada automaticamente no SlashNote
- Repete até todas as tarefas terminarem ou você pausar/parar
O hook Stop é o mecanismo-chave — ele bloqueia o Claude de sair enquanto houver tarefas.
Modos
Tarefas novas (inline)
/note-loop Escrever testes, Implementar feature, Atualizar docsCria uma nota verde fixada com caixas de seleção e começa a executar na hora.
A partir de nota existente (UUID)
/note-loop A550DE30-9B73-4CE5-A138-38F848471329Lê as caixas de seleção desmarcadas de uma nota existente e começa a executá-las.
Agendar para depois (novo Terminal)
/note-loop <uuid> --new-session 2h
/note-loop <uuid> --new-session --sonnetAbre uma nova sessão de Terminal com o delay especificado. Escolha o modelo (Opus, Sonnet, Haiku) e o modo de permissões (plan, acceptEdits, bypassPermissions).
Retomar
/note-loopEncontra a nota do note-loop existente e retoma dos itens desmarcados.
Controle do loop
| Comando | Efeito |
|---|---|
/note-loop pause | Pausa imediata — retome depois com /note-loop |
/note-loop pause after | Pausa graciosa — termina a tarefa atual e depois para |
/note-loop skip <motivo> | Pula a tarefa atual com motivo e segue para a próxima |
/note-loop stop <motivo> | Para o loop completamente e mostra resumo final |
/note-loop list | Lista todos os loops ativos/agendados |
/note-loop cancel <uuid> | Cancela um loop agendado |
Toda ação de pause/stop mostra um resumo de progresso: Feito, Pulado, Restante com percentual de conclusão.
Mecanismos de segurança
| Segurança | Descrição |
|---|---|
| Máx. de iterações | max(30, tarefas * 3) — escala com o número de tarefas |
| Tentativas por tarefa | 3 tentativas antes de marcar como blocked |
| Pause/stop | /note-loop pause ou /note-loop stop a qualquer momento |
| Arquivo de estado | JSON sobrevive a reinicializações de sessão |
| Tarefas blocked | Ficam desmarcadas para acompanhamento manual |
Acompanhamento do progresso
Um gráfico de progresso ao vivo na nota fixada mostra:
- Tarefas feitas (verde)
- Tarefas restantes (cinza)
O gráfico se atualiza automaticamente à medida que o hook Stop processa cada tarefa.
Menu de agendamento
Quando você usa --new-session sem horário, aparece um menu:
| Opção | Descrição |
|---|---|
| Executar agora | Abre novo Terminal e começa na hora |
| Em 1 minuto | Delay curto para verificar o setup |
| Em 30 minutos | Termine o trabalho atual primeiro |
| Em 2 horas | Agendar para depois |
Você também pode digitar um horário personalizado (1h 30m, às 18:00).
Detecção inteligente de diretório
Quando você agenda um loop em uma nova sessão de Terminal, o skill detecta o diretório de trabalho automaticamente:
- Diretórios reais (ex.
/Users/voce/projeto) são usados direto - Diretórios virtuais (ex.
/code, paths do Docker) são detectados e rejeitados - Se o diretório não puder ser determinado, um painel de configuração editável abre no SlashNote para você definir o diretório manualmente
Isso garante que a nova sessão de Terminal sempre rode na raiz correta do projeto.
Config existente
Se uma nota já tem configuração de agendamento (de um /note-loop anterior), o skill reutiliza:
- Diretório, modelo e modo de permissões são preservados
- Você pode editar qualquer campo no painel de configuração antes de começar
- O painel de configuração mostra os ajustes atuais para revisão
Arquivo de estado
O estado do loop fica em .claude/slashnote-loop.local.md (formato JSON). Esse arquivo rastreia:
- Status ativo, índice da tarefa atual
- Listas de tarefas concluídas e blocked
- Contagem e limites de iteração
- Motivos e timestamps de pause/stop