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.150 somente no checkout de desenvolvimento 0.2.2.0.1589 Alpha
89 comandos visíveis
Nenhum comando corresponde à busca. Tente outro nome, categoria ou recurso.
Desenvolvimento
addPythonDocstringsPyPI 0.2.2.0.15AlphaVisualiza ou adiciona docstrings geradas a funções, métodos e classes de um arquivo Python.analyzeComplexityPyPI 0.2.2.0.15AlphaAnalisa métricas de complexidade do código em arquivos ou projetos.auditRepositoryPyPI 0.2.2.0.15AlphaExecuta 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.15AlphaProcura caches, dependências instaladas e artefatos de compilação gerados; por padrão, apenas mostra uma prévia.compareFilesPyPI 0.2.2.0.15AlphaCompara arquivos de texto linha a linha e arquivos binários por bytes exatos e SHA-256.deployProjectPyPI 0.2.2.0.15AlphaVisualiza 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.15AlphaInspeciona 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.15AlphaProcura funções, classes e exportações sem referências visíveis para revisão antes de removê-las.formatCodePyPI 0.2.2.0.15AlphaDetecta a linguagem e executa o formatador correspondente nos arquivos de código-fonte.getGitStatusPyPI 0.2.2.0.15AlphaFornece um resumo estruturado do estado do Git: branch, remoto, alterações e commits recentes.getProjectTreePyPI 0.2.2.0.15AlphaGera uma árvore limitada em ASCII e JSON sem seguir links simbólicos descendentes.planProjectBootstrapPyPI 0.2.2.0.15AlphaCria 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.15AlphaPlaneja 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.15AlphaPerfila as linguagens-fonte e formatos auxiliares de um projeto com percentuais por linhas, arquivos e bytes.scaffoldCPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em C.scaffoldCppPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em C++.scaffoldCSharpPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em C#.scaffoldGoPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em Go.scaffoldJavaPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em Java.scaffoldJavaScriptPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa JavaScript ou Node.js.scaffoldKotlinPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em Kotlin.scaffoldPhpPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um projeto PHP ou Composer.scaffoldPythonPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em Python.scaffoldRustPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em Rust.scaffoldTypeScriptPyPI 0.2.2.0.15AlphaCria uma estrutura básica para um programa em TypeScript.traceCircularImportsPyPI 0.2.2.0.15AlphaSegue importações de módulos e identifica dependências circulares.traceEnvVarPyPI 0.2.2.0.15AlphaRastreia o uso de uma variável de ambiente no código, em .env e em modelos .env.example.
Arquivos
auditWorkspacePyPI 0.2.2.0.15AlphaCria 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.15AlphaCalcula hashes criptográficos MD5, SHA-1 e SHA-256 de um arquivo.changePermissionsPyPI 0.2.2.0.15AlphaAltera as permissões de um arquivo ou diretório.copyPathPyPI 0.2.2.0.15AlphaCopia um arquivo, link simbólico ou diretório para um destino separado, com profundidade e substituição explícitas.countLinesPyPI 0.2.2.0.15AlphaConta 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.15AlphaCria um ou vários diretórios reais com desduplicação, detecção de conflitos e rollback independente por destino.createZipPyPI 0.2.2.0.15AlphaCria 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.15AlphaVisualiza ou remove um arquivo ou diretório do sistema de arquivos.detectFileTypePyPI 0.2.2.0.15AlphaIdentifica 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.15AlphaBaixa um arquivo da Internet, de forma semelhante a wget ou curl.extractZipPyPI 0.2.2.0.15AlphaExtrai um arquivo ZIP após validar caminhos, tipos, limites e conflitos no destino.findBrokenSymlinksPyPI 0.2.2.0.15AlphaProcura links simbólicos quebrados que apontam para arquivos ou diretórios inexistentes.findDuplicateFilesPyPI 0.2.2.0.15AlphaProcura arquivos idênticos por tamanho, SHA-256 e verificação byte a byte.findFilesPyPI 0.2.2.0.15AlphaProcura arquivos por nome, profundidade, tamanho e data de modificação e retorna metadados estruturados.findTextPyPI 0.2.2.0.15AlphaProcura padrões de texto em arquivos com filtros avançados.getHumanLanguageStatsPyPI 0.2.2.0.15AlphaAnalisa arquivos para estimar a distribuição de idiomas humanos; aceita curingas e busca recursiva.inspectImagePyPI 0.2.2.0.15AlphaInspeciona dimensões, formato e tamanho a partir dos cabeçalhos de PNG, JPEG, GIF e BMP.isDirectoryEmptyPyPI 0.2.2.0.15AlphaVerifica 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.15AlphaDetermina se um arquivo regular é binário ou texto usando amostragem limitada do início, meio e fim.isFileEmptyPyPI 0.2.2.0.15AlphaVerifica 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.15AlphaLista arquivos de um diretório com curingas e busca recursiva.movePathPyPI 0.2.2.0.15AlphaMove ou renomeia um arquivo, link simbólico ou diretório completo; rejeita movimentos parciais de diretórios.readFilePyPI 0.2.2.0.15AlphaLê e mostra o conteúdo de um arquivo.repairWorkspacePyPI 0.2.2.0.15AlphaValida um plano salvo do auditWorkspace e aplica somente as ações de limpeza selecionadas que não tenham mudado.touchFilePyPI 0.2.2.0.15AlphaCria um arquivo vazio ou atualiza a marca de tempo de um arquivo existente.
Rede
checkDnsPyPI 0.2.2.0.15AlphaConsulta registros DNS A, AAAA, MX, TXT, NS e CNAME de um domínio.checkSslCertificatePyPI 0.2.2.0.15AlphaInspeciona datas do certificado, cobertura do nome do host e validação da cadeia de confiança.checkUrlStatusPyPI 0.2.2.0.15AlphaConsulta uma URL HTTP e retorna código de status, tempo de resposta e cabeçalhos básicos.diagnoseWebsitePyPI 0.2.2.0.15AlphaDiagnostica por que um site HTTPS pode estar falhando correlacionando DNS, certificado TLS e alcance HTTP em um único fluxo.getNetworkConfigPyPI 0.2.2.0.15AlphaMostra interfaces, IPs locais, DNS, IP pública e detecção de VPN.testInternetSpeedPyPI 0.2.2.0.15AlphaMede a latência HTTP em milissegundos e um download limitado em Mbps e MiB/s.
Sistema
aboutPyPI 0.2.2.0.15AlphaMostra os dados do produto QZX, seu criador, mantenedor e licença.checkExecutablePyPI 0.2.2.0.15AlphaLocaliza um executável no PATH e, somente se solicitado, lê sua saída convencional de --version.checkSystemPathPyPI 0.2.2.0.15AlphaDiagnostica 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.15AlphaLimpa diretamente um terminal interativo sem iniciar cls, clear nem um shell de comandos.diagnoseStoragePyPI 0.2.2.0.15AlphaDiagnostica a pressão de armazenamento combinando capacidade, arquivos grandes e duplicados verificados sem excluir nem modificar arquivos.explainFileWithGeminiPyPI 0.2.2.0.15AlphaMostra 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.15AlphaObtém informações sobre o uso atual da CPU.getCurrentDateTimePyPI 0.2.2.0.15AlphaMostra a data e hora locais atuais com fuso horário, calendário, semana ISO e timestamp.getCurrentDirectoryPyPI 0.2.2.0.15AlphaMostra o diretório de trabalho atual e um inventário útil de seu conteúdo.getCurrentUserPyPI 0.2.2.0.15AlphaObtém informações sobre o usuário conectado.getDiskHealthPyPI 0.2.2.0.15AlphaInspeciona 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.15AlphaObtém informações sobre o uso do espaço em disco.getGpuInfoPyPI 0.2.2.0.15AlphaInspeciona as GPUs instaladas e informa fornecedor, driver, memória e métricas de uso disponíveis.getRamInfoPyPI 0.2.2.0.15AlphaObtém informações detalhadas sobre o uso de RAM.getSystemInfoPyPI 0.2.2.0.15AlphaObté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.15AlphaMostra ajuda para um comando.inspectPortPyPI 0.2.2.0.15AlphaVerifica se uma porta local está ocupada e informa qual processo a possui, sem encerrá-lo.isAdminPyPI 0.2.2.0.15AlphaVerifica se o usuário atual possui privilégios administrativos.killProcessPyPI 0.2.2.0.15AlphaEncerra um processo identificado explicitamente e verifica se ele terminou.listCommandsPyPI 0.2.2.0.15AlphaLista os comandos disponíveis organizados por categoria.listDiskDevicesPyPI 0.2.2.0.15AlphaObtém o nome ou modelo de um disco ou de todos os discos.listProcessesPyPI 0.2.2.0.15AlphaLista os processos em execução com uso real de CPU por amostragem.listStartupProgramsPyPI 0.2.2.0.15AlphaLista programas configurados para serem executados na inicialização do sistema ou da sessão.listSystemServicesPyPI 0.2.2.0.15AlphaLista os serviços do sistema operacional e seu estado de execução.runDiagnosticCommandPyPI 0.2.2.0.15AlphaExecuta um diagnóstico nativo estritamente somente leitura a partir de uma lista permitida específica da plataforma.runScriptPyPI 0.2.2.0.15AlphaExecuta 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.15AlphaExecuta um diagnóstico de CPU, RAM, discos, rede, PATH, serviços, portas e erros do sistema.terminalPyPI 0.2.2.0.15AlphaInicia um terminal interativo para comandos QZX.testDiskSpeedPyPI 0.2.2.0.15AlphaMede escrita sequencial durável e leitura com buffer em MiB/s usando um arquivo temporário de nome exclusivo.versionPyPI 0.2.2.0.15AlphaMostra a versão instalada do QZX e sua identidade estável de produto.welcomePyPI 0.2.2.0.15AlphaMostra 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"