system · Command reference
qzx listCommands
What it does
Lists all available commands organized by category
Command maturity: Alpha
Available for real use and feedback while its interface and behavior can still evolve. This is the current development-checkout assessment. Every future immutable release tag preserves the exact assessment shipped by that version. Available in PyPI 0.2.2.0.6a11. This page documents the 0.2.2.0.6a11 alpha development checkout.
Safety and effects
Read-only under the current classification
No documented dry-run parameter
No native program invocation in the current classification
No documented network use
No inherent elevation requirement
This safety classification was reviewed by OpenAI Codex (authorized project audit) against implementation digest sha256:3339fd02054a4db7a22bf9e69629940f2bd6c27713b26e5d5547436f266818cb on 2026-07-30.
Exact syntax
qzx listCommands [filter_text] --jsonParameters
Swipe or use the horizontal scrollbar to see every column.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| filter_text | str | No | Not declared | Optional text to filter commands by name or description |
Input examples
qzx listCommandsLists all available commands organized by category
qzx listCommands fileLists all commands containing 'file' in their name or description
For the complete structured payload, add --json: qzx listCommands [filter_text] --json
Observed output example
Captured with QZX 0.2.2.0.6a11 on Windows 11; exit code 0. Host-dependent values and duration can vary.
Example command: qzx listCommands --json
{
"success": true,
"message": "Available Commands\nCommands: 89\nMaturity: 89 Alpha\n\n[DEVELOPMENT]\n addPythonDocstrings [Alpha]: Previews or adds generated docstring templates to functions, methods, and classes in one Python file\n analyzeComplexity [Alpha]: Analyzes code complexity metrics for files or projects\n auditRepository [Alpha]: Runs security and quality audits on a Git repository (secrets, large files, duplicates, .gitignore compliance, licenses)\n cleanDevelopmentArtifacts [Alpha]: Finds development caches, dependency directories, and generated build artifacts; preview is the default\n compareFiles [Alpha]: Compares text files line by line and binary files by exact bytes and SHA-256\n deployProject [Alpha]: Previews or deploys one explicit artifact over SSH using a verified remote backup, SHA-256 validation, atomic promotion, health checks, and automatic rollback\n findUnusedCode [Alpha]: Finds functions, classes, and exports with no statically visible references so they can be reviewed for removal\n formatCode [Alpha]: Formats source code files by auto-detecting language and invoking the right formatter\n getGitStatus [Alpha]: Provides a structured summary of the Git repository state (branch, remote, changes, recent commits)\n getProjectTree [Alpha]: Generates a clean visual directory tree (ASCII and JSON) excluding heavy directories like node_modules\n planProjectBootstrap [Alpha]: Builds a selectable project bootstrap plan without writing files, installing dependencies, creating secrets, or running migrations\n prepareRelease [Alpha]: Plans a release metadata update and can atomically update one manifest plus CHANGELOG.md; it never builds, commits, tags, or publishes\n projectDoctor [Alpha]: Inspects project health: detects tech stack, dependencies, environment configuration, Git state, test suites, circular imports, unused-code candidates, and large files\n projectLanguages [Alpha]: Profiles a project's source languages and supporting formats with line, file, and byte percentages\n scaffoldC [Alpha]: Creates a basic scaffolding for a C program\n scaffoldCpp [Alpha]: Creates a basic scaffolding for a C++ program\n scaffoldCSharp [Alpha]: Creates a basic scaffolding for a C# program\n scaffoldGo [Alpha]: Creates a basic scaffolding for a Go program\n scaffoldJava [Alpha]: Creates a basic scaffolding for a Java program\n scaffoldJavaScript [Alpha]: Creates a basic scaffolding for a JavaScript/Node.js program\n scaffoldKotlin [Alpha]: Creates a basic scaffolding for a Kotlin program\n scaffoldPhp [Alpha]: Creates a basic scaffolding for a PHP/Composer program\n scaffoldPython [Alpha]: Creates a basic scaffolding for a Python program\n scaffoldRust [Alpha]: Creates a basic scaffolding for a Rust program\n scaffoldTypeScript [Alpha]: Creates a basic scaffolding for a TypeScript program\n scanProject [Alpha]: Scans a project root to identify technologies, scripts, configuration files, and missing environment keys\n traceCircularImports [Alpha]: Traces module imports recursively and identifies circular import dependencies (loops)\n traceEnvVar [Alpha]: Traces usage of an environment variable across code files, .env, and .env.example templates\n\n[FILE]\n auditWorkspace [Alpha]: Builds a deterministic, fingerprinted workspace cleanup plan without altering workspace contents\n changePermissions [Alpha]: Changes permissions of a file or directory\n copyPath [Alpha]: Copies one file, symbolic link, or directory to a separate destination with explicit depth and replacement behavior\n countLines [Alpha]: Counts the number of lines in files with support for wildcards and recursive searching\n createDirectory [Alpha]: Creates one or more directories at specified paths\n createZip [Alpha]: Compresses a file or directory into an atomic ZIP archive with custom exclusion rules\n deletePath [Alpha]: Previews or deletes a file or directory from the filesystem\n detectFileType [Alpha]: Identifies file type based on its magic number (file signature) rather than extension\n downloadFile [Alpha]: Downloads a file from the Internet (similar to 'wget' or 'curl' in Unix)\n extractZip [Alpha]: Extracts files from a ZIP archive after validating paths, types, limits, and destination conflicts\n findBrokenSymlinks [Alpha]: Scans directories for broken symbolic links (pointing to nonexistent files or folders)\n findDuplicateFiles [Alpha]: Scans a directory for identical files using size, SHA-256, and byte-for-byte verification\n findFiles [Alpha]: Finds files by name, depth, size, and modification date with structured metadata\n findText [Alpha]: Searches for text patterns in files with advanced filtering options\n getFileHash [Alpha]: Calculates cryptographic hashes (MD5, SHA-1, SHA-256) of a file\n getHumanLanguageStats [Alpha]: Analyzes files to estimate human-language distribution, with wildcard and recursive search support.\n getProgrammingLanguageStats [Alpha]: Analyzes files to determine the programming language and provides statistics about the code. Supports wildcards and recursive directory search.\n inspectImage [Alpha]: Inspects image dimensions, format, and size natively from headers (supports PNG, JPEG, GIF, BMP)\n isDirectoryEmpty [Alpha]: Checks if a directory is empty (contains no files or subdirectories)\n isFileBinary [Alpha]: Analyzes a file to determine if it's binary or plain text\n isFileEmpty [Alpha]: Checks if a file is empty (has zero bytes)\n listFiles [Alpha]: Lists files in a directory with support for wildcards and recursive searching\n movePath [Alpha]: Moves or renames one file, symbolic link, or complete directory; partial directory moves are rejected\n readFile [Alpha]: Reads and displays the content of a file\n repairWorkspace [Alpha]: Validates a saved auditWorkspace plan and applies only explicitly selected, unchanged cleanup actions\n touchFile [Alpha]: Creates an empty file or updates the timestamp of an existing file\n\n[NETWORK]\n checkDns [Alpha]: Queries A, AAAA, MX, TXT, NS, and CNAME DNS records for a given domain\n checkSslCertificate [Alpha]: Inspects certificate dates, hostname coverage, and trust-chain validation\n checkUrlStatus [Alpha]: Requests an HTTP(S) URL and reports its status code, response time, and basic headers.\n getNetworkConfig [Alpha]: Displays comprehensive network status (interfaces, local IPs, DNS, public IP, VPN detection)\n testInternetSpeed [Alpha]: Measures HTTP latency in milliseconds and bounded download throughput in Mbps and MiB/s\n\n[SYSTEM]\n about [Alpha]: Displays QZX product, creator, maintainer, and license details\n checkExecutable [Alpha]: Locates an executable in the system PATH and optionally reads its conventional --version output\n checkSystemPath [Alpha]: Diagnoses the system PATH variable, lists broken or duplicate folders, and locates all instances of a binary\n clearScreen [Alpha]: Clears the terminal screen\n explainFileWithGemini [Alpha]: Previews and optionally sends bounded file samples to Google Gemini for explanation\n getCpuLoad [Alpha]: Gets information about current CPU usage\n getCurrentDateTime [Alpha]: Reports the current local date and time with timezone, calendar, ISO-week, and timestamp details\n getCurrentDirectory [Alpha]: Shows the current working directory\n getCurrentUser [Alpha]: Gets information about the currently logged in user\n getDiskHealth [Alpha]: Inspects one disk's S.M.A.R.T. health with smartctl and reports status flags without treating health warnings as command failures\n getDiskSpace [Alpha]: Gets information about disk space usage\n getGpuInfo [Alpha]: Inspects installed GPUs and reports normalized vendor, driver, memory, and available utilization details\n getRamInfo [Alpha]: Gets detailed information about system RAM usage\n getStartupPrograms [Alpha]: Lists all startup programs configured to run on system boot or user login\n help [Alpha]: Shows help for a command\n inspectPort [Alpha]: Checks whether a local port is bound and reports the owning process without terminating it\n isAdmin [Alpha]: Checks if the current user has administrative privileges\n killProcess [Alpha]: Terminates one explicitly identified process and verifies that it exited\n listCommands [Alpha]: Lists all available commands organized by category\n listDiskDevices [Alpha]: Gets disk name/model information for a disk or all disks\n listProcesses [Alpha]: Lists running processes (similar to 'ps' in Unix)\n listSystemServices [Alpha]: Lists operating-system services and their running status\n runDiagnosticCommand [Alpha]: Runs a strictly read-only native system diagnostic from a platform-specific allowlist\n runScript [Alpha]: Executes one explicit Python, Bash, or Windows Batch script with a timeout and bounded retained output\n systemDoctor [Alpha]: Performs a complete diagnostic of the CPU, RAM, disks, network, PATH, services, ports, and system errors\n systemInfo [Alpha]: Gets portable operating-system, Python, user, and environment information with optional RAM and storage details\n terminal [Alpha]: Launches an interactive terminal/shell for QZX commands\n testDiskSpeed [Alpha]: Measures sequential durable-write and buffered-read throughput in MiB/s using a uniquely named temporary file\n version [Alpha]: Displays the current version of QZX and system information\n welcome [Alpha]: Displays the QZX welcome immediately, with optional system details",
"summary": {
"commands": 89,
"categories": 4,
"filter": null
},
"maturity_summary": {
"alpha": 89
},
"commands": {
"system": [
{
"name": "about",
"description": "Displays QZX product, creator, maintainer, and license details",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "checkExecutable",
"description": "Locates an executable in the system PATH and optionally reads its conventional --version output",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "checkSystemPath",
"description": "Diagnoses the system PATH variable, lists broken or duplicate folders, and locates all instances of a binary",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "clearScreen",
"description": "Clears the terminal screen",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "explainFileWithGemini",
"description": "Previews and optionally sends bounded file samples to Google Gemini for explanation",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getCpuLoad",
"description": "Gets information about current CPU usage",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getCurrentDateTime",
"description": "Reports the current local date and time with timezone, calendar, ISO-week, and timestamp details",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getCurrentDirectory",
"description": "Shows the current working directory",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getCurrentUser",
"description": "Gets information about the currently logged in user",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getDiskHealth",
"description": "Inspects one disk's S.M.A.R.T. health with smartctl and reports status flags without treating health warnings as command failures",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getDiskSpace",
"description": "Gets information about disk space usage",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getGpuInfo",
"description": "Inspects installed GPUs and reports normalized vendor, driver, memory, and available utilization details",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getRamInfo",
"description": "Gets detailed information about system RAM usage",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getStartupPrograms",
"description": "Lists all startup programs configured to run on system boot or user login",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "help",
"description": "Shows help for a command",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "inspectPort",
"description": "Checks whether a local port is bound and reports the owning process without terminating it",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "isAdmin",
"description": "Checks if the current user has administrative privileges",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "killProcess",
"description": "Terminates one explicitly identified process and verifies that it exited",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "listCommands",
"description": "Lists all available commands organized by category",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "listDiskDevices",
"description": "Gets disk name/model information for a disk or all disks",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "listProcesses",
"description": "Lists running processes (similar to 'ps' in Unix)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "listSystemServices",
"description": "Lists operating-system services and their running status",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "runDiagnosticCommand",
"description": "Runs a strictly read-only native system diagnostic from a platform-specific allowlist",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "runScript",
"description": "Executes one explicit Python, Bash, or Windows Batch script with a timeout and bounded retained output",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "systemDoctor",
"description": "Performs a complete diagnostic of the CPU, RAM, disks, network, PATH, services, ports, and system errors",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "systemInfo",
"description": "Gets portable operating-system, Python, user, and environment information with optional RAM and storage details",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "terminal",
"description": "Launches an interactive terminal/shell for QZX commands",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "testDiskSpeed",
"description": "Measures sequential durable-write and buffered-read throughput in MiB/s using a uniquely named temporary file",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "version",
"description": "Displays the current version of QZX and system information",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "welcome",
"description": "Displays the QZX welcome immediately, with optional system details",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
}
],
"development": [
{
"name": "addPythonDocstrings",
"description": "Previews or adds generated docstring templates to functions, methods, and classes in one Python file",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "analyzeComplexity",
"description": "Analyzes code complexity metrics for files or projects",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "auditRepository",
"description": "Runs security and quality audits on a Git repository (secrets, large files, duplicates, .gitignore compliance, licenses)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "cleanDevelopmentArtifacts",
"description": "Finds development caches, dependency directories, and generated build artifacts; preview is the default",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "compareFiles",
"description": "Compares text files line by line and binary files by exact bytes and SHA-256",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "deployProject",
"description": "Previews or deploys one explicit artifact over SSH using a verified remote backup, SHA-256 validation, atomic promotion, health checks, and automatic rollback",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "findUnusedCode",
"description": "Finds functions, classes, and exports with no statically visible references so they can be reviewed for removal",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "formatCode",
"description": "Formats source code files by auto-detecting language and invoking the right formatter",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getGitStatus",
"description": "Provides a structured summary of the Git repository state (branch, remote, changes, recent commits)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getProjectTree",
"description": "Generates a clean visual directory tree (ASCII and JSON) excluding heavy directories like node_modules",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "planProjectBootstrap",
"description": "Builds a selectable project bootstrap plan without writing files, installing dependencies, creating secrets, or running migrations",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "prepareRelease",
"description": "Plans a release metadata update and can atomically update one manifest plus CHANGELOG.md; it never builds, commits, tags, or publishes",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "projectDoctor",
"description": "Inspects project health: detects tech stack, dependencies, environment configuration, Git state, test suites, circular imports, unused-code candidates, and large files",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "projectLanguages",
"description": "Profiles a project's source languages and supporting formats with line, file, and byte percentages",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldC",
"description": "Creates a basic scaffolding for a C program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldCpp",
"description": "Creates a basic scaffolding for a C++ program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldCSharp",
"description": "Creates a basic scaffolding for a C# program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldGo",
"description": "Creates a basic scaffolding for a Go program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldJava",
"description": "Creates a basic scaffolding for a Java program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldJavaScript",
"description": "Creates a basic scaffolding for a JavaScript/Node.js program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldKotlin",
"description": "Creates a basic scaffolding for a Kotlin program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldPhp",
"description": "Creates a basic scaffolding for a PHP/Composer program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldPython",
"description": "Creates a basic scaffolding for a Python program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldRust",
"description": "Creates a basic scaffolding for a Rust program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scaffoldTypeScript",
"description": "Creates a basic scaffolding for a TypeScript program",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "scanProject",
"description": "Scans a project root to identify technologies, scripts, configuration files, and missing environment keys",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "traceCircularImports",
"description": "Traces module imports recursively and identifies circular import dependencies (loops)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "traceEnvVar",
"description": "Traces usage of an environment variable across code files, .env, and .env.example templates",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
}
],
"file": [
{
"name": "auditWorkspace",
"description": "Builds a deterministic, fingerprinted workspace cleanup plan without altering workspace contents",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "changePermissions",
"description": "Changes permissions of a file or directory",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "copyPath",
"description": "Copies one file, symbolic link, or directory to a separate destination with explicit depth and replacement behavior",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "countLines",
"description": "Counts the number of lines in files with support for wildcards and recursive searching",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "createDirectory",
"description": "Creates one or more directories at specified paths",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "createZip",
"description": "Compresses a file or directory into an atomic ZIP archive with custom exclusion rules",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "deletePath",
"description": "Previews or deletes a file or directory from the filesystem",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "detectFileType",
"description": "Identifies file type based on its magic number (file signature) rather than extension",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "downloadFile",
"description": "Downloads a file from the Internet (similar to 'wget' or 'curl' in Unix)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "extractZip",
"description": "Extracts files from a ZIP archive after validating paths, types, limits, and destination conflicts",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "findBrokenSymlinks",
"description": "Scans directories for broken symbolic links (pointing to nonexistent files or folders)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "findDuplicateFiles",
"description": "Scans a directory for identical files using size, SHA-256, and byte-for-byte verification",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "findFiles",
"description": "Finds files by name, depth, size, and modification date with structured metadata",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "findText",
"description": "Searches for text patterns in files with advanced filtering options",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getFileHash",
"description": "Calculates cryptographic hashes (MD5, SHA-1, SHA-256) of a file",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getHumanLanguageStats",
"description": "Analyzes files to estimate human-language distribution, with wildcard and recursive search support.",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getProgrammingLanguageStats",
"description": "Analyzes files to determine the programming language and provides statistics about the code. Supports wildcards and recursive directory search.",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "inspectImage",
"description": "Inspects image dimensions, format, and size natively from headers (supports PNG, JPEG, GIF, BMP)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "isDirectoryEmpty",
"description": "Checks if a directory is empty (contains no files or subdirectories)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "isFileBinary",
"description": "Analyzes a file to determine if it's binary or plain text",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "isFileEmpty",
"description": "Checks if a file is empty (has zero bytes)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "listFiles",
"description": "Lists files in a directory with support for wildcards and recursive searching",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "movePath",
"description": "Moves or renames one file, symbolic link, or complete directory; partial directory moves are rejected",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "readFile",
"description": "Reads and displays the content of a file",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "repairWorkspace",
"description": "Validates a saved auditWorkspace plan and applies only explicitly selected, unchanged cleanup actions",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "touchFile",
"description": "Creates an empty file or updates the timestamp of an existing file",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
}
],
"network": [
{
"name": "checkDns",
"description": "Queries A, AAAA, MX, TXT, NS, and CNAME DNS records for a given domain",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "checkSslCertificate",
"description": "Inspects certificate dates, hostname coverage, and trust-chain validation",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "checkUrlStatus",
"description": "Requests an HTTP(S) URL and reports its status code, response time, and basic headers.",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "getNetworkConfig",
"description": "Displays comprehensive network status (interfaces, local IPs, DNS, public IP, VPN detection)",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
},
{
"name": "testInternetSpeed",
"description": "Measures HTTP latency in milliseconds and bounded download throughput in Mbps and MiB/s",
"maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
}
}
]
},
"meta": {
"command": "listCommands",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 4.754,
"schema_version": 1
}
}View the JSON result contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"commands": [],
"maturity_summary": [],
"summary": []
},
"additionalProperties": true
}Errors and limits
The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.
QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.
Evidence workflow: captured and digest-validated.
Evidence and provenance
- Implementation
- src/qzx/commands/system/list_commands.py
- Tests
- No command-specific test file with the same module name was found; this does not prove that all coverage is absent.
- Documentation channel
- Development documentation 0.2.2.0.6a11 · main · sha256:d1bf56371df81b2a79619d8219eed92ccf790be1584c528e211381ca7aa85302
- Availability
- 0.2.2.0.6a11 or earlier
Keep exploring
Related commands
These commands also belong to the system category. Compare them to choose the operation that best fits your task.