VoxRunner

VoxRunner is a safety-first voice task runner CLI. It maps spoken transcripts to pre-approved commands and requires explicit confirmation before execution.

Workflow

1. Speech-to-text (external) produces a transcript.
2. VoxRunner matches transcript to configured task profile.
3. Safety policy validates command (blocks dangerous patterns).
4. User approves execution (or passes --yes).

Quick start

npm install
npm run build
cp voxrunner.tasks.example.json voxrunner.tasks.json
node dist/cli.js list
node dist/cli.js match "start dev server"
node dist/cli.js run "run tests"

CLI

• voxrunner list [--file <path>]
• voxrunner match "<transcript>" [--file <path>]
• voxrunner run "<transcript>" [--yes] [--file <path>]

Scripts

• npm run dev
• npm run typecheck
• npm test
• npm run build

License

MIT