Metadata-Version: 2.3
Name: woz
Version: 0.1.2
Summary: Woz (short for Wozniak) is a simple cli know-it-all.
Author: Robin van der Noord
Author-email: Robin van der Noord <robinvandernoord@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Dist: openai>=1.68,<2
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# Woz

Woz (short for Wozniak) is a simple CLI know-it-all.

## Install

```bash
uvenv install woz
```

Requires [uvenv](https://github.com/robinvandernoord/uvenv).
Alternatively, you can install with `pip`, `pipx`, or `uv tool`.

## Configure

Set your OpenRouter API key:

```bash
export WOZ_APIKEY="sk-or-..."
```

Optionally pick a model (defaults to `google/gemini-3.1-flash-lite-preview`):

```bash
export WOZ_MODEL="openrouter/free"
```

## Use

```bash
woz who is Wozniak
woz --bash "gti diff"
```

Great for:

- Siri-esque search in Pikabar (see [examples/pikabar.qml](examples/pikabar.qml))
- A Bash `command_not_found_handle` that suggests fixes (see [examples/command_not_found_handle.sh](examples/command_not_found_handle.sh))
