Metadata-Version: 2.4
Name: vox-cli
Version: 0.1.0
Summary: Voice comments for your terminal. Push-to-talk for Claude Code, Cursor, and any CLI.
Author: beee003
License: MIT
License-File: LICENSE
Keywords: cli,developer-tools,speech-to-text,terminal,voice
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: click>=8.1.0
Requires-Dist: faster-whisper>=1.0.0
Requires-Dist: mcp>=1.2.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pynput>=1.7.6
Requires-Dist: pyperclip>=1.8.2
Requires-Dist: sounddevice>=0.4.6
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# vox

Voice comments for your terminal. Push-to-talk for Claude Code, Cursor, and any CLI.

## Install

```bash
pip install vox-cli
```

## Quick Start

```bash
# One-shot: speak and get text
vox say

# Push-to-talk daemon (hold Right Alt to record)
vox listen

# List audio devices
vox devices
```

## Features

- **Local-first** — runs Whisper locally, no cloud API calls
- **Code-aware cleaning** — fixes capitalization of `API`, `JSON`, `None`, etc.
- **Voice casing** — say "snake case my variable name" → `my_variable_name`
- **Multiple outputs** — clipboard (default), stdout, or simulated paste
- **Push-to-talk** — configurable hotkey, silence detection auto-stops

## Options

```
vox listen --model small      # tiny|base|small|medium
vox listen --output stdout    # clipboard|stdout|paste
vox listen --key f5           # any modifier or function key
vox say --duration 15         # max recording seconds
vox --verbose listen          # debug logging
```

## Requirements

- Python 3.10+
- A microphone
- macOS: grant Terminal Accessibility permission for hotkey support

## License

MIT
