Files
hyprvoice/AGENTS.md
T

1.1 KiB

AGENTS.md

This repo is a Go CLI + daemon for voice-powered typing on Wayland/Hyprland.

Build and run

  • go mod download
  • go build -o hyprvoice ./cmd/hyprvoice
  • go run ./cmd/hyprvoice

Main structure (short)

  • cmd/hyprvoice: CLI entrypoint and commands
  • internal/daemon: daemon lifecycle + IPC command handling
  • internal/pipeline: recording -> transcription -> processing -> injection state machine
  • internal/recording: PipeWire capture
  • internal/transcriber: batch/streaming adapters
  • internal/llm: post-processing adapters and prompts
  • internal/injection: wtype/ydotool/clipboard backends
  • internal/provider: provider registry + model metadata
  • internal/config: config load/validate + hot reload

Runtime quick facts

  • IPC: unix socket at ~/.cache/hyprvoice/control.sock, single-character commands
  • Config: ~/.config/hyprvoice/config.toml (hot reloaded by daemon)

Docs

  • docs/structure.md: code map and entry points
  • docs/architecture.md: deeper architecture + adapters/interfaces
  • docs/config.md: config reference and paths
  • docs/providers.md: provider and model details
  • packaging/RELEASE.md: release and AUR workflow