Vox

AI-powered text rewriting directly inside your macOS apps.

Vox is a native Swift menu bar app that rewrites selected text in place, exposes NSServices actions system-wide, supports configurable rewrite hotkeys, and includes speech-to-text with both local and hosted engines.

Documentation | Changelog | License

Features

• Context-menu rewriting through macOS NSServices
• Global rewrite hotkeys
• Speech-to-text with local and hosted engines
• Reusable rewrite presets and prompt overrides
• In-place text replacement with host-app undo support
• Native settings UI for rewrite, popover, speech, permissions, and updates

Install

make install
make flush

Launch Vox.app from /Applications.

On first launch, Vox automatically opens Settings > Permissions. The same page is reopened on later launches whenever Accessibility or Microphone access is missing.

Development

# Build the native app
make build

# Build and open the app bundle
make dev

# Run native tests
make test

# Run native hygiene checks
make lint

# Install git hooks that run the release gate before commits
make install-hooks

# Reinstall to /Applications
make install

# Flush the macOS Services cache after service changes
make flush

The repository no longer supports the legacy Python/PyObjC runtime. Build, test, release, and packaging flows all target VoxNative.xcodeproj.

Release

make release-check
make release-package
./scripts/release.sh 1.5.0

Release artifacts are generated as zip and dmg bundles from the native app under build/native/DerivedData.

Troubleshooting

Services not appearing

Run make flush and relaunch the installed app.

Hotkeys not working

Grant Accessibility access in Settings > Permissions, then re-open Vox.

Speech not starting

Grant Microphone access in Settings > Permissions and confirm your selected speech engine is configured.

License

This project is licensed under the Apache License 2.0. See LICENSE.