fork-terminal

name	fork-terminal
description	Abre multiplas abas no Windows Terminal para execucao paralela de Claude Code
version	2.0.0
author	SuperJurista
triggers	["fork terminal","abrir terminais","paralelo","pthread","multiplos processos"]

Fork Terminal Skill

Executor de paralelizacao via multiplas abas do Windows Terminal Automacao de terminal, execucao paralela, P-Thread Permitir execucao paralela de Claude Code em multiplas abas do Windows Terminal Processar multiplos processos judiciais simultaneamente, aumentando throughput N abas abertas, cada uma executando Claude Code com um comando especifico

<quando_usar> - Usuario pede para "abrir terminais em paralelo" - Usuario menciona "fork terminal" ou "pthread" - Usuario quer processar multiplos processos judiciais ao mesmo tempo - Usuario pede para "rodar N instancias" de algo

- NAO usar para tarefas que precisam de contexto compartilhado - NAO usar se usuario quer resultado consolidado (usar Task tool) - NAO usar para menos de 2 comandos (sem beneficio) Passar comandos com espacos e barras via linha de comando envolve multiplas camadas de interpretacao (Git Bash -> PowerShell -> wt.exe -> CMD -> Claude). Cada camada tem regras diferentes de escape, causando corrupcao dos argumentos. Usar arquivos batch temporarios elimina problemas de escape. Cada aba recebe seu proprio arquivo .bat com o comando completo. Os arquivos sao criados em %TEMP%/fork-terminal/ e executados via wt.exe. 1. Script PowerShell recebe array de prompts 2. Para cada prompt, cria arquivo .bat em %TEMP%/fork-terminal/ 3. Cada .bat contem: cd, set CLAUDE_CONFIG_DIR, claude "prompt" 4. wt.exe abre N abas, cada uma executando seu .bat Identifique quais comandos o usuario quer executar em paralelo. - Se for pipeline-sentenca: extrair caminhos dos processos - Se for comando generico: usar diretamente Montar array PowerShell com os prompts: ``` @('/pipeline-sentenca path1', '/pipeline-sentenca path2') ``` Usar Bash com MSYS_NO_PATHCONV=1 para evitar conversao de paths: ```bash MSYS_NO_PATHCONV=1 powershell.exe -ExecutionPolicy Bypass -Command "& '.claude/skills/fork-terminal/scripts/fork-terminal.ps1' -Prompts @('/comando arg1', '/comando arg2') -Claude 'claude2'" ``` Informar ao usuario: - Quantas abas foram abertas - Qual comando esta rodando em cada uma - Como acompanhar o progresso (Ctrl+Tab no Windows Terminal) Usuario: "Processa esses 2 processos em paralelo: data/decisao/0808008 e data/decisao/0805304" ```bash MSYS_NO_PATHCONV=1 powershell.exe -ExecutionPolicy Bypass -Command "& '.claude/skills/fork-terminal/scripts/fork-terminal.ps1' -Prompts @('/pipeline-sentenca data/decisao/0808008-27.2025.4.05.8100', '/pipeline-sentenca data/decisao/0805304-75.2024.4.05.8100') -Claude 'claude2'" ``` 2 abas abertas no Windows Terminal, cada uma processando um processo judicial. Usuario: "Fork 3 terminais para revisar o modulo de autenticacao" ```bash MSYS_NO_PATHCONV=1 powershell.exe -ExecutionPolicy Bypass -Command "& '.claude/skills/fork-terminal/scripts/fork-terminal.ps1' -Prompts @('Review the authentication module for security issues', 'Review the authentication module for performance issues', 'Review the authentication module for code quality') -Claude 'claude2'" ``` 3 revisoes paralelas do mesmo codigo, cada uma com foco diferente. Depois o usuario pode consolidar os resultados (F-Thread / Fusion). Executar sem Windows Terminal instalado Abrir mais de 10 abas (limite pratico por RAM/CPU) Usar YOLO mode para execucao nao-interativa Usar MSYS_NO_PATHCONV=1 antes do comando PowerShell Informar ao usuario quantas abas foram abertas Conceito do framework Thread-Based Engineering de IndyDevDan. Multiplos agentes rodando em paralelo, cada um com seu contexto isolado. Usuario prompta no inicio, revisa no final de cada thread. Variacao onde multiplos agentes recebem o MESMO prompt. Resultados sao consolidados/fundidos pelo usuario. Util para aumentar confianca em revisoes. Flag --dangerously-skip-permissions do Claude Code. Permite execucao sem confirmacao interativa. Necessario para automacao e paralelizacao. Variavel de ambiente que desabilita conversao automatica de paths no Git Bash. Sem ela, /pipeline-sentenca vira C:/Program Files/Git/pipeline-sentenca. SEMPRE usar antes de chamar powershell.exe com paths que comecam com /. Solucao para evitar problemas de escape em multiplas camadas de shell. Cada comando e escrito em um arquivo .bat separado. O wt.exe executa os .bat, que contem o comando sem necessidade de escape. Instalado via Microsoft Store ou winget. Comando: wt.exe Ja vem instalado no Windows 10/11. Instalado globalmente: npm install -g @anthropic-ai/claude-code | Recurso | Limite | Razao | |---------|--------|-------| | Abas | 10 | RAM/CPU - cada instancia consome ~200-400MB | | Prompts | Sem limite de tamanho | Arquivos batch suportam comandos longos | | Contas Claude | claude, claude1, claude2 | Configuradas via CLAUDE_CONFIG_DIR |