qzx getCurrentUser

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 getCurrentUser --json

{
    "success": true,
    "message": "Gets information about the currently logged in user. In this illustrative example, the command completed successfully.",
    "current_directory": "C:\\project\\example.txt",
    "environment_variables": {
        "PATH_entries": 14,
        "shell": "PowerShell"
    },
    "home_directory": "C:\\Users\\developer",
    "processes": {
        "value": [
            {
                "pid": 4210,
                "name": "python",
                "cpu_percent": 4.2,
                "memory_readable": "82.4 MiB"
            }
        ]
    },
    "shell": "Example value",
    "user_id": "Example value",
    "username": "developer"
}

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "current_directory": [],
        "environment_variables": {
            "type": "object",
            "properties": [],
            "additionalProperties": true
        },
        "error": [],
        "home_directory": [],
        "processes": {
            "oneOf": [
                {
                    "type": "object",
                    "properties": [],
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "count": [],
                        "total_memory_usage": []
                    },
                    "additionalProperties": true
                }
            ]
        },
        "shell": [],
        "user_id": [],
        "username": {
            "oneOf": [
                {
                    "type": "null"
                },
                {
                    "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.

Evidence workflow: ready for deterministic automated capture.