talk/README.md

talk

Status: WIP — aktive Entwicklung (talk 2.0). Binde Spezifikation: .scratch/talk-2-0/spec.md · Implementierungsplan: .scratch/talk-2-0/plan.md

talk macht Skripte und KI-Agenten hörbar: Ein Aufruf — talk "Build fertig" — spricht eine kurze Nachricht über eine TTS-Provider-Kette (ElevenLabs → OpenAI → Edge-TTS → OS-Stimme), serialisiert durch den Daemon talkd. Cross-platform (Windows/macOS/Linux, amd64/arm64), statische Binaries, keine Runtime-Abhängigkeiten.

Befehle

Befehl	Zweck
talk "Text"	Ansage — Abkürzung für talk say, non-blocking
talk say "Text"	Ansage (Text als Argument oder von stdin)
talk wrap -- <Befehl>	Befehl ausführen, Erfolg/Misserfolg + Dauer ansagen
talk mute / talk unmute	Ansagen dauerhaft stummschalten / Stummschaltung aufheben
talk status	Daemon-Status (Queue, Mute, Provider, Version)
talk cancel	laufende und geplante Ansagen abbrechen
talk voices	verfügbare Stimmen anzeigen
talk test	Test-Ansage ausgeben
talk doctor	Selbstdiagnose des Setups
talk setup	geführte Ersteinrichtung (Wizard)

Say-Flags (gelten auch für talk "Text"): --wait, --now, --priority, --voice, --lang, --provider.

Hinweis: Alle Befehle sind in diesem Stand Stubs und melden not implemented yet (Exit-Code ≠ 0). Die Implementierung entsteht Aufgabenweise gemäß Plan; --version und --help funktionieren.

Entwicklung

go build ./...   # bauen
go test ./...    # Tests
go vet ./...     # statische Analyse
gofmt -l .       # Formatierung prüfen (leerer Output = ok)

CI: .gitea/workflows/test.yml (Gitea Actions) läuft vet, gofmt-Check, Tests und Build bei jedem Push und Pull Request.

Lizenz

MIT — siehe LICENSE.