Metadata-Version: 2.4
Name: ozx
Version: 0.1.1
Summary: ozx, a plugin launcher: `ozx <name>` runs the ozx-<name> executable on the PATH, as git and kubectl do
Project-URL: Homepage, https://drycraf.com
Author: drycraf
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: cli,launcher,ozx,plugins
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# ozx

`ozx` is a plugin launcher: `ozx <name> [args]` runs the `ozx-<name>` executable on the PATH, as git and kubectl do.

```
$ ozx plugins
hello
$ ozx hello --name you
```

| Command | What it does |
|---|---|
| `ozx plugins` | Lists the `ozx-<name>` plugins found on the PATH |
| `ozx version` | Prints the version |
| `ozx <name> [args]` | Runs `ozx-<name>` with the arguments, and exits with its exit code (127: no such plugin) |

A plugin is any executable named `ozx-<name>` in a PATH directory; the first one found wins. On Windows the Rust
build also runs `ozx-<name>.cmd` and `.bat`; the npm and PyPI builds run `.exe` plugins only.

## Install

| Channel | Command | Build |
|---|---|---|
| crates.io | `cargo install ozx-cli` | Rust |
| Homebrew | `brew install ozx4/tap/ozx` | Rust, built from the crates.io source |
| npm | `npm install -g ozx`, or `npx ozx` | a JavaScript port (Node 18+) |
| PyPI | `pipx install ozx`, or `uv tool install ozx` | a Python port (3.8+) |

Each behaves the same, checked by one conformance test.

## The full ozx

The full `ozx`, drycraf's platform command line, comes with drycraf: <https://drycraf.com>. It uses this launcher for
its plugins.

## Licence

Apache-2.0. "ozx" and "drycraf" are trademarks of drycraf; the licence grants no trademark rights.
