# `mix ptc`
[🔗](https://github.com/andreasronge/ptc_runner/blob/main/lib/mix/tasks/ptc.ex#L1)

Runs any stable PTC command through the shared parser and frontend:

    mix ptc help
    mix ptc init DIRECTORY
    mix ptc run DIRECTORY/ptc-project.json
    mix ptc validate ptc.json
    mix ptc run ptc.json --input alternate-input.json
    mix ptc doctor ptc.json --host-config ptc-host.json --connect
    mix ptc models --host-config ptc-host.json

Use `mix ptc help COMMAND` to list every switch accepted by a command.
The task always prints the shared human rendering. `--envelope PATH`
additionally publishes the machine-readable V4 envelope atomically; for
`transcript`, the envelope is published only after the private document
succeeds.
Complete doctor readiness reports, including `readiness: "failed"`, are
written to standard output. A failed readiness report retains its nonzero
exit status; failures without a complete report are written to standard
error. Runtime logger output, including TLS handshake alerts, is written
to standard error so standard output remains one JSON document.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
