Skip to main content

QZX in action

One command. A result you can use.

See QZX turn everyday terminal tasks into clear answers for people and predictable JSON for agents and automation.

Explore the outputs Browse all commands
qzx · structured result

$ qzx getCurrentDateTime --output-format iso --json

"success": true

"date": "2026-09-08"

"day_of_week": "Tuesday"

3useful tasks
JSONready to parse
1clear contract

Three everyday tasks

The output explains itself

Each command returns an immediate summary plus structured fields that software can use without scraping terminal prose.

01 Date and calendar

Know the date in one call

Get an ISO date, a readable sentence, and useful calendar fields in the same response.

Answer
2026-09-08
Calendar fields
10 included
SUCCESS · EXIT 0 
$ qzx getCurrentDateTime --output-format iso --json
{
    "success": true,
    "message": "Current local date and time (ISO 8601): 2026-09-08T19:19:57.029830-05:00.",
    "output": "2026-09-08T19:19:57.029830-05:00",
    "output_format": "iso",
    "date": {
        "year": 2026,
        "month": 9,
        "month_name": "September",
        "day": 8,
        "day_of_week": "Tuesday",
        "day_of_year": 251,
        "iso_week": 37,
        "iso_week_year": 2026,
        "quarter": 3,
        "is_leap_year": false
    },
    "time": {
        "hour_24": 19,
        "hour_12": 7,
        "minute": 19,
        "second": 57,
        "microsecond": 29830,
        "am_pm": "PM",
        "timezone": "Hora est. Pacífico, Sudamérica",
        "utc_offset": "-05:00"
    },
    "timestamp": 1788913197,
    "iso_format": "2026-09-08T19:19:57.029830-05:00",
    "meta": {
        "command": "getCurrentDateTime",
        "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": 2.348,
        "schema_version": 1
    }
}
02 File discovery

Find the files and the totals

One recursive search reports the matches, their combined size, and the exact result list.

Matches
2
Total size
13.00 B
2 MATCHES · EXIT 0 
$ qzx findFiles ../artifacts/qzx-evidence/find-files "*.txt" -r --json
{
    "success": true,
    "message": "Found 2 matching files in 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files'. Returning 2 files totaling 13.00 B.",
    "search_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files",
    "pattern": "*.txt",
    "recursive": "unlimited",
    "filters": {
        "min_size_bytes": null,
        "max_size_bytes": null,
        "modified_after": null,
        "modified_before": null,
        "exclude": [],
        "exclude_dirs": []
    },
    "sort": {
        "by": "path",
        "descending": false
    },
    "matched_count": 2,
    "matched_size_bytes": 13,
    "matched_size_readable": "13.00 B",
    "count": 2,
    "total_size_bytes": 13,
    "total_size_readable": "13.00 B",
    "limit": null,
    "truncated": false,
    "skipped_unreadable": 0,
    "warnings": [],
    "results": [
        {
            "name": "alpha.txt",
            "path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files\\alpha.txt",
            "relative_path": "alpha.txt",
            "depth": 0,
            "size_bytes": 7,
            "size_readable": "7.00 B",
            "modified_timestamp": 1788913185.7912128,
            "modified_at": "2026-09-08T19:19:45-05:00"
        },
        {
            "name": "beta.txt",
            "path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files\\nested\\beta.txt",
            "relative_path": "nested\\beta.txt",
            "depth": 1,
            "size_bytes": 6,
            "size_readable": "6.00 B",
            "modified_timestamp": 1788913185.7912128,
            "modified_at": "2026-09-08T19:19:45-05:00"
        }
    ],
    "meta": {
        "command": "findFiles",
        "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": 3.926,
        "schema_version": 1
    }
}
03 Directory creation

Do the work. Report every result.

Create multiple directories in one request and receive a per-path confirmation alongside the summary.

Requested
2
Created
2
2 CREATED · EXIT 0 
$ 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
    }
}

Ready for your terminal?

Make the next command predictable

Install the published release, then choose a task from the command catalog.

Open the command catalog
About these example runs

The evidence registry contains 23 successful command captures from 8 September 2026 with QZX development runtime 0.2.2.0.8, CPython 3.13.13, and Windows 11 10.0.26200. This page highlights three; other command pages display their own implementation-bound records. Timing and host-specific values naturally vary. Review the full evidence status in the command catalog or the platform scope on the compatibility page.