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.

qzx · structured result

$ qzx getCurrentDate --json

"success": true

"date": "2026-07-23"

"day_of_week": "Thursday"

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-07-23
Calendar fields
7 included
SUCCESS · EXIT 0
$ qzx getCurrentDate --json
{
  "success": true,
  "date": "2026-07-23",
  "message": "Current date is Thursday, July 23, 2026 (ISO format: 2026-07-23)",
  "details": {
    "year": 2026,
    "month": 7,
    "month_name": "July",
    "day": 23,
    "day_of_week": "Thursday",
    "day_of_year": 204,
    "week_of_year": 30
  },
  "meta": {
    "command": "getCurrentDate",
    "duration_ms": 0.115,
    "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
80 B
2 MATCHES · EXIT 0
$ qzx findFiles examples/qzx_in_action "*.txt" -r --format name --json
{
  "success": true,
  "message": "Found 2 items in 'examples/qzx_in_action', total size: 80.00 B",
  "search_path": "examples/qzx_in_action",
  "pattern": "*.txt",
  "recursive": "unlimited",
  "count": 2,
  "total_size": 80,
  "total_size_readable": "80.00 B",
  "results": [
    "alpha.txt",
    "beta.txt"
  ],
  "meta": {
    "command": "findFiles",
    "duration_ms": 0.995,
    "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 of 2 directories.",
  "details": {
    "requested": 2,
    "created": 2,
    "failed": 0,
    "results": [
      "✓ Directory created: artifacts/qzx-evidence/created-one",
      "✓ Directory created: artifacts/qzx-evidence/created-two"
    ]
  },
  "meta": {
    "command": "createDirectory",
    "duration_ms": 1.326,
    "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

These outputs were recorded on 25 July 2026 with QZX development runtime 0.2.2.0.2, CPython 3.13.12, and Windows 11 10.0.26200. Each example exited with code 0. Timing and host-specific values naturally vary. You can inspect the two text fixtures or review platform coverage on the compatibility page.