Guia do SWG bar CLI

O SWG bar inclui uma ferramenta nativa de linha de comando (swgbar) dentro de /Applications/SWGBar.app. Ela oferece os mesmos recursos de monitoramento e inspeção em tempo real do aplicativo da barra de menus do macOS, permitindo auditar certificados TLS, avaliar a interceptação HTTPS e gerenciar regras de bypass de SWG diretamente do Terminal ou por scripts.

Configuração da CLI

Após instalar o SWG bar, o executável fica localizado no pacote do aplicativo. Você pode executá-lo diretamente, definir um alias no seu perfil de shell (~/.zshrc ou ~/.bashrc) ou criar um link simbólico no seu PATH:

# Opção 1: Executar diretamente do pacote do aplicativo
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opção 2: Adicionar um alias ao perfil da shell (~/.zshrc ou ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opção 3: Criar um link simbólico em /usr/local/bin (recomendado para acesso global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verificar a instalação e a versão
swgbar version

Adicione --json a qualquer comando para receber saídas estruturadas em formato JSON, ideal para processamento com jq ou automação.

Métricas gerais, domínios e certificados

Consulte os mesmos dados em tempo real e evidências de certificados exibidos no aplicativo da barra de menus:

# Exibir o percentual geral de inspeção HTTPS, contagem por status e principais certificados
swgbar overview

# Listar domínios observados com filtros opcionais e paginação
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Exibir evidências detalhadas de conexão TLS e certificado de um domínio específico
swgbar domains detail <domain>

# Listar agrupamentos de certificados e exibir detalhes de um certificado específico
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

Sondagem de domínios e gerenciamento do bypass de SWG

Execute verificações TLS em tempo real para qualquer hostname ou gerencie regras de bypass de SWG por domínio:

# Sondar um domínio sob demanda para avaliar a confiança do certificado e a inspeção TLS
swgbar probe <domain>

# Consultar o status atual do bypass de SWG e as regras ativas
swgbar bypass status

# Ativar, alternar, desativar ou limpar as regras de bypass de um domínio
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

Extensão do navegador e preferências do aplicativo

Verifique a conectividade da extensão do navegador, pause ou retome o monitoramento em segundo plano e configure as preferências do aplicativo:

# Verificar o status de conexão da extensão complementar para Chrome
swgbar plugins status
swgbar plugins check

# Verificar, pausar ou retomar o monitoramento em segundo plano
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Gerenciar o status da licença, verificar atualizações e alterar idioma ou aparência
swgbar license status
swgbar updates check
swgbar language get
swgbar language set <en|zh-Hans|zh-Hant|ja|ko>
swgbar appearance get
swgbar appearance set <system|light|dark>

Comandos frequentes

Comando	Descrição
swgbar overview	Exibe a taxa geral de inspeção HTTPS, estatísticas de status e principais certificados interceptores
swgbar domains list	Lista os domínios observados com suporte a --search, --status, --bypass, --page e --page-size
swgbar domains detail <domain>	Exibe metadados de conexão, evidências da cadeia de certificados e status de bypass
swgbar certificates list	Lista os agrupamentos de certificados com filtros de --search e --status
swgbar certificates detail "<certificate-name>"	Exibe emissor, período de validade, impressão digital SHA-256 e domínios associados
swgbar bypass <status|enable|disable|toggle|clear>	Consulta ou gerencia as regras de bypass de SWG por domínio
swgbar probe <domain>	Realiza uma sondagem TLS sob demanda e avaliação de certificados para um domínio
swgbar plugins <status|check>	Verifica a conectividade com a extensão complementar do navegador
swgbar monitoring <status|pause|resume>	Consulta, pausa ou retoma o monitoramento de rede em segundo plano
swgbar license <status|activate|deactivate>	Consulta ou gerencia o status de ativação da licença
swgbar updates check	Verifica atualizações de software disponíveis
swgbar language <get|set>	Consulta ou define o idioma de exibição (en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	Consulta ou define o tema de aparência (system, light, dark)

Para integrar o SWG bar com clientes de IA, consulte o guia do MCP. Para entender como as evidências de certificados são avaliadas, leia como o SWG bar funciona.