Instale o Tucano do seu jeito
CLI, terminal e inspector web local ou um app desktop separado. Confira a disponibilidade dos canais e escolha sua plataforma.
Um proxy. Escolha onde trabalhar.
Use comandos, inspecione no terminal ou abra a interface web local. A CLI independente dispensa o desktop; o app nativo tem download separado.
- CLI
- Automatize capturas e consulte sessões nomeadas com saída JSON estruturada.
- TUI
- Inspecione requisições no terminal. Fechar o inspector mantém o serviço em execução.
- Inspector web
- Abra a interface autenticada no Maestri, no Orca ou no navegador do sistema.
- App desktop
- Instale o app nativo Tauri separadamente para usar uma janela dedicada no desktop.
Instalar a CLI
macOS, Linux e Windows. Escolha como instalar, sem precisar do app desktop.
curl -fsSL https://github.com/plscabral/tucano-proxy/releases/latest/download/install.sh | shDownload manual
Usando um agente de IA?Skill para agentes
Adicione a skill ao seu agente para trabalhar com o Tucano. Ela instala instruções, não o executável da CLI.
npx skills add plscabral/tucano-proxy --skill tucano-proxyInstalar a CLI não instala uma CA confiável nem altera o proxy do sistema. A captura recebe apenas tráfego encaminhado ao listener; confiança HTTPS e roteamento pelo sistema exigem consentimentos separados.
Inicie uma sessão
O setup guia o primeiro uso. Repita o nome da sessão nos comandos para a TUI e o inspector web exibirem as mesmas capturas.
Ler o guia da CLI →tucano-proxy --session demo setup
tucano-proxy --session demo start
tucano-proxy --session demo tui
tucano-proxy --session demo web --openNo seu fluxo com Maestri e Orca
O comando web detecta o terminal em uso. No modo interativo, oferece o navegador integrado, o navegador do sistema ou cancelar. Com --json, auto escolhe o app detectado sem perguntar; Maestri tem prioridade quando ambos são detectados.
A abertura usa uma credencial local. Não compartilhe URLs autenticadas. O comando abre o inspector web, não o aplicativo desktop.
tucano-proxy --session demo web --open --target maestri
tucano-proxy --session demo web --open --target orca
tucano-proxy --session demo web --open --target browserApp desktop
Instale o app nativo Tauri separadamente para usar uma janela dedicada no desktop.
macOS
Windows
Linux
Desktop: encaminhe, capture e inspecione.
Confie na CA para HTTPS, se precisar
O Tucano gera uma CA local e te guia na instalação. Necessário só pra inspecionar HTTPS — e você revoga quando quiser.
Encaminhe o tráfego necessário
Inicie a captura e configure o proxy do aplicativo alvo. No macOS/Windows, o toggle do desktop configura opcionalmente o proxy do sistema para apps que respeitam essa opção.
Capture e filtre
As requisições aparecem na lista virtualizada em tempo real. Filtre com a DSL e salve a sessão em .tucano.
100% open source
MIT. Bugs, ideias e PRs bem-vindos. Sem licença, sem telemetria, sem paywall.
Ver no GitHub