development · Command reference
qzx scanProject
What it does
Scans a project root to identify technologies, scripts, configuration files, and missing environment keys
Canonical command: scanProject
Accepted aliases: None
Case-sensitive: no
Included in the published package
Available in PyPI 0.2.2.0.2. This page documents the 0.2.2.0.2 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 against implementation digest sha256:f48e9d0cf956983d31462e511d40d4175a994ba6791e4959cca39d1b36276e97 on 2026-07-24.
Exact syntax
qzx scanProject [project_path] --jsonParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| project_path | str | No | "." | Path to the project root directory (defaults to current directory) |
Input examples
qzx scanProjectScan the current workspace directory
qzx scanProject C:/my-projects/appScan the project located at C:/my-projects/app
For the complete structured payload, add --json: qzx scanProject [project_path] --json
Representative output example
This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.
Example command: qzx scanProject --json
{
"success": true,
"message": "Scans a project root to identify technologies, scripts, configuration files, and missing environment keys. In this illustrative example, the command completed successfully.",
"configuration_files": [
"pyproject.toml",
"package.json"
],
"environment_diagnostics": [
{
"name": "example",
"status": "ok"
}
],
"package_json": "Example value",
"package_managers": [
"pnpm",
"pip"
],
"php_dependencies": [
{
"name": "example",
"status": "ok"
}
],
"project_path": "C:\\project\\example.txt",
"project_types": [
"Python",
"Node.js"
],
"python_dependencies": [
"psutil",
"PyYAML"
]
}View the JSON result contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"configuration_files": [],
"environment_diagnostics": [],
"error": {
"type": "string"
},
"package_json": [],
"package_managers": [],
"php_dependencies": [],
"project_path": [],
"project_types": [],
"python_dependencies": []
},
"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: ready for deterministic automated capture.
Evidence and provenance
- Implementation
- src/qzx/commands/development/scan_project.py
- Documentation channel
- Development documentation 0.2.2.0.2 · main · sha256:319b16857a87636ebc3b89734cc040a737bb56194464fca33ce73bdae2043096
- Availability
- 0.2.2.0.2 or earlier
Keep exploring
Related commands
These commands also belong to the development category. Compare them to choose the operation that best fits your task.
qzx scaffoldTypescriptCreates a basic scaffolding for a TypeScript programqzx traceCircularImportsTraces module imports recursively and identifies circular import dependencies (loops)qzx scaffoldRustCreates a basic scaffolding for a Rust programqzx traceEnvVarTraces usage of an environment variable across code files, .env, and .env.example templates