file · Command reference
qzx createDirectory
What it does
Creates one or more real directories with deduplication, conflict detection, and per-target rollback on failure
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.8. This page documents the 0.2.2.0.8 alpha development checkout.
Behavior and built-in protections
Live mode applies the changes you request
Direct execution for this operation
Works without invoking native programs
Works without network access
No elevation required by design
This safety classification was reviewed by OpenAI GPT-5.6 Pro against implementation digest sha256:902b158008896ce4683ee6c457beffc870050415324dbf7ddf46ed0fc87273cd on 2026-08-25.
Exact syntax
qzx createDirectory <directory_paths> --jsonParameters
Swipe or use the horizontal scrollbar to see every column.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| directory_paths | list[str] | Yes | Not declared | One or more real directory paths to create |
Input examples
qzx createDirectory "ProjectFolder"Create one directory named "ProjectFolder"
qzx createDirectory "src/components" "src/styles" "src/utils"Create several project directories and report every target independently
For the complete structured payload, add --json: qzx createDirectory <directory_paths> --json
Observed output example
Captured with QZX 0.2.2.0.8 on Windows 11; exit code 0. Host-dependent values and duration can vary.
Example command: qzx createDirectory ../artifacts/qzx-evidence/created-one ../artifacts/qzx-evidence/created-two --json
{
"success": true,
"message": "Created 2 target directories; 0 already existed and 0 duplicates were skipped.",
"details": {
"requested": 2,
"normalized_unique": 2,
"created": 2,
"already_existed": 0,
"duplicates": 0,
"failed": 0,
"directories_created": 2,
"directories_rolled_back": 0,
"directories_retained_after_command": 2,
"filesystem_changed": true,
"link_traversal_allowed": false,
"rollback_policy": "empty_directories_created_by_a_failed_target",
"operations": [
{
"request_index": 1,
"requested_path": "../artifacts/qzx-evidence/created-one",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-one",
"status": "created",
"changed": true,
"created_paths": [
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-one"
],
"concurrent_directories": []
},
{
"request_index": 2,
"requested_path": "../artifacts/qzx-evidence/created-two",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-two",
"status": "created",
"changed": true,
"created_paths": [
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-two"
],
"concurrent_directories": []
}
]
},
"meta": {
"command": "createDirectory",
"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": 8.179,
"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
},
"details": {
"type": "object",
"properties": {
"requested_count": [],
"maximum_path_count": [],
"filesystem_changed": {
"type": "boolean"
}
},
"additionalProperties": true
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"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.
{
"success": false,
"error_code": "directory_creation_failed",
"error": "1 of 1 path request failed.",
"message": "Created 0 target directories; 0 already existed, 0 duplicates were skipped, and 1 failed.",
"details": {
"requested": 1,
"normalized_unique": 0,
"created": 0,
"already_existed": 0,
"duplicates": 0,
"failed": 1,
"directories_created": 0,
"directories_rolled_back": 0,
"directories_retained_after_command": 0,
"filesystem_changed": false,
"link_traversal_allowed": false,
"rollback_policy": "empty_directories_created_by_a_failed_target",
"operations": [
{
"request_index": 1,
"requested_path": "",
"status": "failed",
"changed": false,
"error_code": "invalid_directory_path",
"error": "Directory paths must not be empty."
}
]
},
"meta": {
"command": "createDirectory",
"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.236,
"schema_version": 1
}
}Captured command: qzx createDirectory "" --json
Evidence workflow: captured and digest-validated.
Evidence and provenance
- Implementation
- src/qzx/commands/file/create_directory.py
- Documentation channel
- Development documentation 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Availability
- 0.2.2.0.8 or earlier
Keep exploring
Related commands
These commands also belong to the file category. Compare them to choose the operation that best fits your task.
qzx countLinesCounts logical Unicode lines in a stable regular file using bounded-memory streaming and explicit newline evidenceqzx createZipCompresses a file or directory into an atomic ZIP archive with custom exclusion rulesqzx copyPathCopies one file, symbolic link, or directory to a separate destination with explicit depth and replacement behaviorqzx deletePathPreviews or deletes a file or directory from the filesystem