QZX_SAFETYAlto riscoCom YOLO, ignora globalmente a aprovação e o backup de segurança dos comandos de alto risco. Equivale a usar --yolo em cada operação e deve ser limitado a sessões controladas.
- Valores
YOLO- Padrão
proteção ativa
Referência
89 comandos, um vocabulário multiplataforma
Explore o catálogo atual do QZX. Cada ficha documenta descrição, parâmetros, exemplos e, quando aplicável, notas de segurança. Os nomes dos comandos permanecem iguais em todos os idiomas para que automações sejam portáveis.
Como escolher
Comece pelo problema, não pelo nome da ferramenta. Diagnósticos compostos como diagnoseProject, diagnoseStorage e diagnoseWebsite costumam economizar mais trabalho; comandos menores são úteis quando você precisa de uma operação específica.
qzx listCommandsqzx help diagnoseProject89 comandos documentados
Referência indexável por comando
Cada link abre uma página SSR com maturidade, sintaxe, parâmetros, disponibilidade, riscos, exemplos e evidência de implementação.
89 incluídos no PyPI 0.2.2.0.90 somente no checkout de desenvolvimento 0.2.2.0.989 Alpha
89 comandos visíveis
Nenhum comando corresponde à busca. Tente outro nome, categoria ou recurso.
Desenvolvimento
addPythonDocstringsPyPI 0.2.2.0.9AlphaVisualiza ou adiciona docstrings geradas a funções, métodos e classes de um arquivo Python.analyzeComplexityPyPI 0.2.2.0.9AlphaAnalisa métricas de complexidade do código em arquivos ou projetos.auditRepositoryPyPI 0.2.2.0.9AlphaExecuta auditorias de segurança e qualidade em um repositório Git: segredos, arquivos grandes, duplicados, conformidade com .gitignore e licenças.cleanDevelopmentArtifactsPyPI 0.2.2.0.9AlphaProcura caches, dependências instaladas e artefatos de compilação gerados; por padrão, apenas mostra uma prévia.compareFilesPyPI 0.2.2.0.9AlphaCompara arquivos de texto linha a linha e arquivos binários por bytes exatos e SHA-256.deployProjectPyPI 0.2.2.0.9AlphaVisualiza ou implanta um artefato explícito por SSH com backup remoto verificado, validação SHA-256, promoção atômica, verificação de saúde e rollback automático.diagnoseProjectPyPI 0.2.2.0.9AlphaInspeciona tecnologias, dependências, fluxos de validação, estado do Git, qualidade do código e arquivos grandes sem executar scripts do projeto.findUnusedCodePyPI 0.2.2.0.9AlphaProcura funções, classes e exportações sem referências visíveis para revisão antes de removê-las.formatCodePyPI 0.2.2.0.9AlphaDetecta a linguagem e executa o formatador correspondente nos arquivos de código-fonte.getGitStatusPyPI 0.2.2.0.9AlphaFornece um resumo estruturado do estado do Git: branch, remoto, alterações e commits recentes.getProjectTreePyPI 0.2.2.0.9AlphaGera uma árvore limitada em ASCII e JSON sem seguir links simbólicos descendentes.planProjectBootstrapPyPI 0.2.2.0.9AlphaCria um plano selecionável para iniciar um projeto sem gravar arquivos, instalar dependências, criar segredos ou executar migrações.prepareReleasePyPI 0.2.2.0.9AlphaPlaneja a atualização dos metadados de uma versão e pode modificar atomicamente um manifesto e CHANGELOG.md; nunca compila, faz commit, cria tag nem publica.projectLanguagesPyPI 0.2.2.0.9AlphaPerfila as linguagens-fonte e formatos auxiliares de um projeto com percentuais por linhas, arquivos e bytes.scaffoldCPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em C.scaffoldCppPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em C++.scaffoldCSharpPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em C#.scaffoldGoPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em Go.scaffoldJavaPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em Java.scaffoldJavaScriptPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa JavaScript ou Node.js.scaffoldKotlinPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em Kotlin.scaffoldPhpPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um projeto PHP ou Composer.scaffoldPythonPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em Python.scaffoldRustPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em Rust.scaffoldTypeScriptPyPI 0.2.2.0.9AlphaCria uma estrutura básica para um programa em TypeScript.traceCircularImportsPyPI 0.2.2.0.9AlphaSegue importações de módulos e identifica dependências circulares.traceEnvVarPyPI 0.2.2.0.9AlphaRastreia o uso de uma variável de ambiente no código, em .env e em modelos .env.example.
Arquivos
auditWorkspacePyPI 0.2.2.0.9AlphaCria um plano determinístico com impressões digitais de conteúdo para revisar possíveis limpezas sem alterar o workspace.calculateFileHashPyPI 0.2.2.0.9AlphaCalcula hashes criptográficos MD5, SHA-1 e SHA-256 de um arquivo.changePermissionsPyPI 0.2.2.0.9AlphaAltera as permissões de um arquivo ou diretório.copyPathPyPI 0.2.2.0.9AlphaCopia um arquivo, link simbólico ou diretório para um destino separado, com profundidade e substituição explícitas.countLinesPyPI 0.2.2.0.9AlphaConta linhas lógicas Unicode de um arquivo regular estável com streaming de memória limitada e evidência explícita de quebras de linha.createDirectoryPyPI 0.2.2.0.9AlphaCria um ou vários diretórios reais com desduplicação, detecção de conflitos e rollback independente por destino.createZipPyPI 0.2.2.0.9AlphaCria um arquivo ZIP atômico a partir de um arquivo ou diretório, com regras de exclusão configuráveis.deletePathPyPI 0.2.2.0.9AlphaVisualiza ou remove um arquivo ou diretório do sistema de arquivos.detectFileTypePyPI 0.2.2.0.9AlphaIdentifica um arquivo regular por assinaturas de conteúdo limitadas, refinamento opcional com libmagic e comparação explícita da extensão.downloadFilePyPI 0.2.2.0.9AlphaBaixa um arquivo da Internet, de forma semelhante a wget ou curl.extractZipPyPI 0.2.2.0.9AlphaExtrai um arquivo ZIP após validar caminhos, tipos, limites e conflitos no destino.findBrokenSymlinksPyPI 0.2.2.0.9AlphaProcura links simbólicos quebrados que apontam para arquivos ou diretórios inexistentes.findDuplicateFilesPyPI 0.2.2.0.9AlphaProcura arquivos idênticos por tamanho, SHA-256 e verificação byte a byte.findFilesPyPI 0.2.2.0.9AlphaProcura arquivos por nome, profundidade, tamanho e data de modificação e retorna metadados estruturados.findTextPyPI 0.2.2.0.9AlphaProcura padrões de texto em arquivos com filtros avançados.getHumanLanguageStatsPyPI 0.2.2.0.9AlphaAnalisa arquivos para estimar a distribuição de idiomas humanos; aceita curingas e busca recursiva.inspectImagePyPI 0.2.2.0.9AlphaInspeciona dimensões, formato e tamanho a partir dos cabeçalhos de PNG, JPEG, GIF e BMP.isDirectoryEmptyPyPI 0.2.2.0.9AlphaVerifica de forma estável se um diretório está vazio, com contagens em streaming, política explícita para ocultos e sem seguir links por padrão.isFileBinaryPyPI 0.2.2.0.9AlphaDetermina se um arquivo regular é binário ou texto usando amostragem limitada do início, meio e fim.isFileEmptyPyPI 0.2.2.0.9AlphaVerifica se um arquivo tem zero bytes ou apenas espaços Unicode por decodificação em streaming e sem seguir links por padrão.listFilesPyPI 0.2.2.0.9AlphaLista arquivos de um diretório com curingas e busca recursiva.movePathPyPI 0.2.2.0.9AlphaMove ou renomeia um arquivo, link simbólico ou diretório completo; rejeita movimentos parciais de diretórios.readFilePyPI 0.2.2.0.9AlphaLê e mostra o conteúdo de um arquivo.repairWorkspacePyPI 0.2.2.0.9AlphaValida um plano salvo do auditWorkspace e aplica somente as ações de limpeza selecionadas que não tenham mudado.touchFilePyPI 0.2.2.0.9AlphaCria um arquivo vazio ou atualiza a marca de tempo de um arquivo existente.
Rede
checkDnsPyPI 0.2.2.0.9AlphaConsulta registros DNS A, AAAA, MX, TXT, NS e CNAME de um domínio.checkSslCertificatePyPI 0.2.2.0.9AlphaInspeciona datas do certificado, cobertura do nome do host e validação da cadeia de confiança.checkUrlStatusPyPI 0.2.2.0.9AlphaConsulta uma URL HTTP e retorna código de status, tempo de resposta e cabeçalhos básicos.diagnoseWebsitePyPI 0.2.2.0.9AlphaDiagnostica por que um site HTTPS pode estar falhando correlacionando DNS, certificado TLS e alcance HTTP em um único fluxo.getNetworkConfigPyPI 0.2.2.0.9AlphaMostra interfaces, IPs locais, DNS, IP pública e detecção de VPN.testInternetSpeedPyPI 0.2.2.0.9AlphaMede a latência HTTP em milissegundos e um download limitado em Mbps e MiB/s.
Sistema
aboutPyPI 0.2.2.0.9AlphaMostra os dados do produto QZX, seu criador, mantenedor e licença.checkExecutablePyPI 0.2.2.0.9AlphaLocaliza um executável no PATH e, somente se solicitado, lê sua saída convencional de --version.checkSystemPathPyPI 0.2.2.0.9AlphaDiagnostica a variável PATH, lista diretórios quebrados ou duplicados e localiza todas as instâncias de um binário.clearScreenPyPI 0.2.2.0.9AlphaLimpa diretamente um terminal interativo sem iniciar cls, clear nem um shell de comandos.diagnoseStoragePyPI 0.2.2.0.9AlphaDiagnostica a pressão de armazenamento combinando capacidade, arquivos grandes e duplicados verificados sem excluir nem modificar arquivos.explainFileWithGeminiPyPI 0.2.2.0.9AlphaMostra uma prévia e, após autorização explícita, envia amostras limitadas de um arquivo ao Google Gemini para obter uma explicação.getCpuLoadPyPI 0.2.2.0.9AlphaObtém informações sobre o uso atual da CPU.getCurrentDateTimePyPI 0.2.2.0.9AlphaMostra a data e hora locais atuais com fuso horário, calendário, semana ISO e timestamp.getCurrentDirectoryPyPI 0.2.2.0.9AlphaMostra o diretório de trabalho atual e um inventário útil de seu conteúdo.getCurrentUserPyPI 0.2.2.0.9AlphaObtém informações sobre o usuário conectado.getDiskHealthPyPI 0.2.2.0.9AlphaInspeciona a saúde S.M.A.R.T. de um disco com smartctl e distingue alertas do disco de falhas do comando.getDiskSpacePyPI 0.2.2.0.9AlphaObtém informações sobre o uso do espaço em disco.getGpuInfoPyPI 0.2.2.0.9AlphaInspeciona as GPUs instaladas e informa fornecedor, driver, memória e métricas de uso disponíveis.getRamInfoPyPI 0.2.2.0.9AlphaObtém informações detalhadas sobre o uso de RAM.getSystemInfoPyPI 0.2.2.0.9AlphaObtém informações portáteis sobre sistema operacional, Python, usuário e ambiente, com detalhes opcionais de RAM e armazenamento.helpPyPI 0.2.2.0.9AlphaMostra ajuda para um comando.inspectPortPyPI 0.2.2.0.9AlphaVerifica se uma porta local está ocupada e informa qual processo a possui, sem encerrá-lo.isAdminPyPI 0.2.2.0.9AlphaVerifica se o usuário atual possui privilégios administrativos.killProcessPyPI 0.2.2.0.9AlphaEncerra um processo identificado explicitamente e verifica se ele terminou.listCommandsPyPI 0.2.2.0.9AlphaLista os comandos disponíveis organizados por categoria.listDiskDevicesPyPI 0.2.2.0.9AlphaObtém o nome ou modelo de um disco ou de todos os discos.listProcessesPyPI 0.2.2.0.9AlphaLista os processos em execução.listStartupProgramsPyPI 0.2.2.0.9AlphaLista programas configurados para serem executados na inicialização do sistema ou da sessão.listSystemServicesPyPI 0.2.2.0.9AlphaLista os serviços do sistema operacional e seu estado de execução.runDiagnosticCommandPyPI 0.2.2.0.9AlphaExecuta um diagnóstico nativo estritamente somente leitura a partir de uma lista permitida específica da plataforma.runScriptPyPI 0.2.2.0.9AlphaExecuta um script local explícito de Python, Bash ou Windows Batch com timeout e saída retida de forma limitada.systemDoctorPyPI 0.2.2.0.9AlphaExecuta um diagnóstico de CPU, RAM, discos, rede, PATH, serviços, portas e erros do sistema.terminalPyPI 0.2.2.0.9AlphaInicia um terminal interativo para comandos QZX.testDiskSpeedPyPI 0.2.2.0.9AlphaMede escrita sequencial durável e leitura com buffer em MiB/s usando um arquivo temporário de nome exclusivo.versionPyPI 0.2.2.0.9AlphaMostra a versão instalada do QZX e sua identidade estável de produto.welcomePyPI 0.2.2.0.9AlphaMostra imediatamente as boas-vindas do QZX e, opcionalmente, informações do sistema.
Configuração da CLI
Variáveis de ambiente
O QZX lê estas variáveis do ambiente do processo. Um valor definido no terminal afeta os comandos iniciados nessa sessão; ao removê-lo, o QZX volta ao comportamento padrão.
Atenção: QZX_SAFETY=YOLO desativa uma barreira de recuperação para todos os comandos de alto risco da sessão. Não transforme isso em uma configuração permanente.
Segurança e backups
Controlam a proteção antes de operações de alto risco e o arquivo que o QZX cria antes de modificar dados.
QZX_BACKUPS_PATHAltera o diretório em que o QZX salva os backups automáticos. Caminhos com ~ e variáveis do sistema são expandidos antes da criação do arquivo.
- Valores
caminho de diretório- Padrão
~/QZX-Backups
QZX_BACKUPS_FORMATEscolhe o contêiner do backup. ZIP e TAR.GZ aceitam compressão; TAR preserva os dados sem compressão.
- Valores
ZIP · TAR.GZ · TAR- Padrão
ZIP
QZX_BACKUPS_COMPRESSIONAjusta a compressão. 0 armazena sem comprimir e 9 prioriza o menor tamanho; no formato TAR, o valor efetivo é sempre store.
- Valores
store · fastest · fast · normal · maximum · 0–9- Padrão
fastest
Privacidade, diagnóstico e integrações
Configuram a telemetria pseudônima da CLI, seu estado local e serviços opcionais.
QZX_TELEMETRYUse 0 para desativar a telemetria de ativação ou 1 para ativá-la explicitamente. QZX_TELEMETRY=1 tem prioridade sobre DO_NOT_TRACK=1.
- Valores
0 · 1- Padrão
1 (ativada)
DO_NOT_TRACKDesativa a telemetria quando vale 1, a menos que QZX_TELEMETRY a ative ou desative explicitamente.
- Valores
1- Padrão
não definida
QZX_TELEMETRY_STATE_DIRAltera o local do estado pseudônimo de telemetria; é útil em instalações portáteis e testes.
- Valores
caminho de diretório- Padrão
diretório de dados do sistema
QZX_TELEMETRY_DEBUGGrava diagnósticos de entrega de telemetria em stderr. Não altera o resultado do comando.
- Valores
1 · true · yes · on · enabled- Padrão
desativada
GEMINI_API_KEYSegredoCredencial preferencial para explainFileWithGemini. O QZX a lê do ambiente do processo ou do arquivo .env no diretório atual; trate-a como segredo e nunca a publique nem a inclua no controle de versão.
- Valores
chave de API- Padrão
não definida
GEMINI_API_TOKENSegredoCredencial de compatibilidade aceita por explainFileWithGemini quando GEMINI_API_KEY não está definida. O QZX também pode lê-la do arquivo .env no diretório atual; trate-a como segredo e nunca a publique nem a inclua no controle de versão.
- Valores
token de API- Padrão
não definida
Exemplos por terminal
As atribuições exportadas duram até você encerrar a sessão ou remover a variável. Substitua os valores conforme sua política.
Linux / macOS / POSIX
QZX_TELEMETRY=0 qzx welcome
export QZX_BACKUPS_FORMAT=TAR.GZ
export QZX_BACKUPS_COMPRESSION=fastestWindows PowerShell
$env:QZX_TELEMETRY = "0"
$env:QZX_BACKUPS_FORMAT = "TAR.GZ"
$env:QZX_BACKUPS_COMPRESSION = "fastest"