Initial commit

commands/info.md

@@ -0,0 +1,32 @@
+---
+description: Show subscription and usage information
+---
+
+Display ElevenLabs subscription tier, character usage, and historical stats.
+
+## Usage
+
+```bash
+elevenlabs-tts-tool info [--days N]
+```
+
+## Arguments
+
+- `--days, -d N`: Number of days of historical usage (default: 7)
+
+## Examples
+
+```bash
+# View subscription with last 7 days
+elevenlabs-tts-tool info
+
+# View last 30 days
+elevenlabs-tts-tool info --days 30
+
+# Quick quota check
+elevenlabs-tts-tool info --days 1
+```
+
+## Output
+
+Subscription tier, quota usage, remaining characters, and daily usage breakdown.

commands/list-models.md

@@ -0,0 +1,28 @@
+---
+description: List ElevenLabs TTS models
+---
+
+List all available ElevenLabs TTS models with characteristics.
+
+## Usage
+
+```bash
+elevenlabs-tts-tool list-models
+```
+
+## Examples
+
+```bash
+# List all models
+elevenlabs-tts-tool list-models
+
+# Filter by status
+elevenlabs-tts-tool list-models | grep stable
+
+# Find specific features
+elevenlabs-tts-tool list-models | grep -i "ultra-low"
+```
+
+## Output
+
+Detailed model information with IDs, features, languages, and use cases.

commands/list-voices.md

@@ -0,0 +1,28 @@
+---
+description: List available ElevenLabs voices
+---
+
+List all available ElevenLabs voices with characteristics.
+
+## Usage
+
+```bash
+elevenlabs-tts-tool list-voices
+```
+
+## Examples
+
+```bash
+# List all voices
+elevenlabs-tts-tool list-voices
+
+# Filter by gender
+elevenlabs-tts-tool list-voices | grep female
+
+# Filter by accent
+elevenlabs-tts-tool list-voices | grep British
+```
+
+## Output
+
+Table format with voice name, gender, age, accent, and description.

commands/synthesize.md

@@ -0,0 +1,44 @@
+---
+description: Convert text to speech with ElevenLabs
+argument-hint: text
+---
+
+Convert TEXT to speech using ElevenLabs API. Play through speakers or save to file.
+
+## Usage
+
+```bash
+elevenlabs-tts-tool synthesize TEXT [OPTIONS]
+```
+
+## Arguments
+
+- `TEXT`: Text to synthesize (required, or use --stdin)
+- `--stdin, -s`: Read text from stdin instead
+- `--voice, -v NAME`: Voice name or ID (default: rachel)
+- `--model, -m ID`: Model ID (default: eleven_turbo_v2_5)
+- `--output, -o PATH`: Save to file instead of playing
+- `--format, -f FORMAT`: Output format (default: mp3_44100_128)
+
+## Examples
+
+```bash
+# Basic usage
+elevenlabs-tts-tool synthesize "Hello world"
+
+# Different voice
+elevenlabs-tts-tool synthesize "Hello" --voice adam
+
+# Emotional expression (requires eleven_v3)
+elevenlabs-tts-tool synthesize "[happy] Welcome!" --model eleven_v3
+
+# Read from stdin
+echo "Text" | elevenlabs-tts-tool synthesize --stdin
+
+# Save to file
+elevenlabs-tts-tool synthesize "Text" --output speech.mp3
+```
+
+## Output
+
+Plays audio through speakers or saves to file in specified format.

commands/update-voices.md

@@ -0,0 +1,29 @@
+---
+description: Update voice lookup table from API
+---
+
+Fetch latest voices from ElevenLabs API and update local lookup table.
+
+## Usage
+
+```bash
+elevenlabs-tts-tool update-voices [--output PATH]
+```
+
+## Arguments
+
+- `--output, -o PATH`: Output file path (default: ~/.config/elevenlabs-tts-tool/voices_lookup.json)
+
+## Examples
+
+```bash
+# Update default voice lookup
+elevenlabs-tts-tool update-voices
+
+# Save to custom location
+elevenlabs-tts-tool update-voices --output custom_voices.json
+```
+
+## Output
+
+Updates voice lookup table with latest premade voices from API.