# Voicemode Quickstart

> Microphone access required when waitforresponse=True. Audio processed via STT service, not stored.

- Skill: `tools-only/voicemode-quickstart-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/voicemode-quickstart-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/voicemode-quickstart-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/voicemode-quickstart-2

---

# Voicemode Quickstart

## Basic Usage

### Simple conversation
```python
converse("What's your name?")
```
System auto-selects voice and model.

### Make a statement and wait
```python
converse("Tell me more about that")
```

### Speak without waiting for response
```python
converse("Goodbye!", wait_for_response=False)
```

### User requests specific voice
```python
converse("Hello", voice="nova")
```
Only specify voice when explicitly requested by user.

## Common Patterns

### Quick confirmation (no response needed)
```python
converse("Done! The file is saved", wait_for_response=False)
```

### Ask a question (wait for answer)
```python
converse("Which file should I open?")
```

### Status update during work
```python
converse("Searching for that file now", wait_for_response=False)
# Then immediately run grep/search tools
```

## Privacy Note
Microphone access required when `wait_for_response=True`. Audio processed via STT service, not stored.

## See Also
- [Parameters](parameters.md) - Full parameter reference
- [Patterns](patterns.md) - Advanced conversation patterns
- [Languages](languages.md) - Non-English language support
- [Troubleshooting](troubleshooting.md) - Common issues and solutions