nex-voice

name	nex-voice
description	Voice note transcription and intelligent action item extraction for capture and organization of verbal communication. Record and transcribe voice notes, voice messages, and meeting recordings in Dutch and English using OpenAI Whisper with selectable model quality (tiny to large). Automatically extract structured action items from transcripts including tasks (moet, must), reminders (vergeet niet, don't forget), scheduled calls, email actions, meetings (afspraken), decisions, and deadline-based items. Full-text search across all transcripts to find past conversations and action items by keyword. Manage extracted actions with completion tracking, priority levels, and due date assignment. View pending and overdue action items to stay on top of commitments. Optional LLM integration for intelligent action extraction and transcript summarization. Perfect for busy professionals, meeting attendees, and business owners who prefer speaking notes over typing and need to convert voice into organized action items and searchable records. All audio files and transcripts stay secure on your machine.
version	1.0.0
metadata	{"clawdbot":{"emoji":"🎤","requires":{"bins":["python3","whisper","ffmpeg"],"env":[]},"primaryEnv":"","homepage":"https://nex-ai.be","files":["nex-voice.py","lib/*","setup.sh"]}}

Nex Voice

Voice note transcription and action item extraction. Automatically transcribe voice notes with OpenAI Whisper, extract action items (tasks, reminders, calls, meetings, decisions, deadlines), and manage them locally. Supports Dutch and English. All data stays on your machine.

When to Use

Use this skill when the user asks about:

• Transcribing a voice note, voice message, or audio file
• Extracting action items from voice notes (tasks, reminders, calls, meetings)
• Searching through voice note transcripts
• Managing action items or tasks from voice notes
• What was discussed in a voice note or meeting recording
• Pending or overdue action items
• Statistics about voice notes and transcriptions
• Exporting transcripts

Trigger phrases: "transcribe", "voice note", "voice message", "audio file", "action item", "what did we discuss", "extract tasks", "pending tasks", "spraakbericht", "wat is besproken", "actie", "afspraak"

Quick Setup

If this is your first time using nex-voice, run the setup script:

bash setup.sh

This checks for required dependencies (Whisper and FFmpeg), sets up the data directory at ~/.nex-voice, initializes the database, and tests the installation.

Available Commands

The CLI tool is nex-voice. All commands output plain text.

Transcribe

Transcribe an audio file:

nex-voice transcribe /path/to/voice.ogg
nex-voice transcribe /path/to/voice.ogg --language en
nex-voice transcribe /path/to/voice.ogg --speaker "Kevin"
nex-voice transcribe /path/to/voice.ogg --tags "client-meeting,proposal"

Options:

• --language: Language code (en for English, nl for Dutch). Default: nl
• --speaker: Name of the speaker for attribution
• --tags: Comma-separated tags for organization

Returns: Recording ID and transcript summary.

Extract Actions

Extract action items from a recording:

nex-voice actions 42
nex-voice actions --last
nex-voice actions 42 --use-llm

Options:

• Recording ID or --last for the most recent recording
• --use-llm: Use configured LLM for intelligent extraction (optional)

List Recordings

List all recordings:

nex-voice list
nex-voice list --since 2026-03-01
nex-voice list --speaker "Kevin"
nex-voice list --tag "client-meeting"

Show Recording

Show full details of a recording:

nex-voice show 42

Displays: transcript, summary, extracted actions, metadata.

Search Transcripts

Full-text search across all transcripts:

nex-voice search "offerte"
nex-voice search "offerte" --since 2026-04-01

Pending Actions

List all pending action items:

nex-voice pending
nex-voice pending --type task
nex-voice pending --type reminder

Types: task, reminder, call, email, meeting, decision, deadline

Complete Action

Mark an action item as complete:

nex-voice complete 7

Overdue Actions

Show overdue action items:

nex-voice overdue

Export Transcript

Export a transcript:

nex-voice export 42 --format txt
nex-voice export 42 --format json

Statistics

Show statistics:

nex-voice stats

Displays: total recordings, total hours transcribed, languages, action items extracted, pending/overdue counts.

Configuration

View or set configuration:

nex-voice config show
nex-voice config set-whisper-model base
nex-voice config set-whisper-model large
nex-voice config set-language nl
nex-voice config set-api-key
nex-voice config set-provider openai
nex-voice config set-model gpt-4o
nex-voice config set-api-base https://api.openai.com/v1

Example Interactions

User: "Transcribe this voice note for me" Agent runs: nex-voice transcribe /path/to/file.ogg Agent: Shows recording ID and presents the transcript with extracted action items.

User: "What action items came from the last recording?" Agent runs: nex-voice actions --last Agent: Presents the extracted actions (tasks, reminders, calls, meetings, decisions, deadlines).

User: "Search my voice notes for anything about the proposal" Agent runs: nex-voice search "proposal" Agent: Lists matching transcripts and highlights relevant sections.

User: "What tasks are still pending from voice notes?" Agent runs: nex-voice pending --type task Agent: Shows all incomplete tasks with due dates and assignments.

User: "Mark task 7 as done" Agent runs: nex-voice complete 7 Agent: Confirms completion and updates the database.

User: "Show me overdue actions" Agent runs: nex-voice overdue Agent: Lists all overdue items with their recordings and context.

Output Parsing

All CLI output is plain text, structured for easy parsing:

• Section headers followed by --- separators
• List items prefixed with -
• Timestamps in ISO-8601 format
• Action items include: ID, type, description, assigned_to, due_date, priority, status
• Every command output ends with [Nex Voice by Nex AI | nex-ai.be]

When presenting output to the user, strip the footer line and present the information naturally.

Features

Transcription

• Supports OGG, MP3, WAV, M4A, OPUS, WEBM formats
• Automatic audio conversion using ffmpeg if needed
• Language detection and support for Dutch (default) and English
• Whisper model selection (tiny, base, small, medium, large)
• Duration tracking and maximum 600-second audio limit

Action Extraction

• Pattern-based extraction with Dutch and English keywords:
  • Tasks: "moet", "must", "do"
  • Reminders: "vergeet niet", "don't forget"
  • Calls: "bel", "call"
  • Emails: "mail", "stuur email", "send email"
  • Meetings: "afspraak", "meeting"
  • Decisions: "besloten", "decided"
  • Deadlines: "deadline", "voor", "by"
• Intelligent extraction with optional LLM (OpenAI, Claude, etc.)
• Automatic date parsing (morgen=tomorrow, vrijdag=Friday, etc.)
• Speaker and assignee detection

Storage & Management

• Local SQLite database at ~/.nex-voice/
• Full-text search across transcripts
• Tag-based organization
• Speaker attribution
• Completion tracking with timestamps

Optional LLM Features

• Intelligent action extraction from transcripts
• Summary generation
• Requires explicit configuration: API key, provider, model
• Supported providers: OpenAI, Anthropic Claude, local LLMs

Important Notes

• All voice data is stored locally at ~/.nex-voice/. No telemetry, no analytics.
• No external API calls are made unless you explicitly configure an LLM provider.
• Whisper CLI must be installed (pip install openai-whisper or faster-whisper).
• FFmpeg must be installed for audio format conversion.
• Maximum audio duration: 600 seconds (10 minutes). Longer files are rejected.
• LLM features are optional and require explicit configuration.
• Supported audio formats: OGG, MP3, WAV, M4A, OPUS, WEBM

Troubleshooting

• "whisper: command not found": Install with pip install openai-whisper
• "ffmpeg: command not found": Install FFmpeg from ffmpeg.org
• "Database not found": Run bash setup.sh to initialize
• "No transcripts found": Run nex-voice list to see all recordings
• "LLM not configured": Run nex-voice config set-api-key to enable LLM features

Credits

Built by Nex AI (https://nex-ai.be) - Digital transformation for Belgian SMEs. Author: Kevin Blancaflor