Toak/IDEAS.md

Feature Ideas for Toak

A curated list of CLI-native features to enhance the dictation workflow.

---

2. Bring Your Own Script (BYOS) Window Context

Allow the LLM's system prompt to dynamically adapt based on the currently focused application (e.g., formatting as code for alacritty, or conversational for discord).

• Implementation: Add a ContextCommand string to ToakConfig.cs (e.g., ~/.config/toak/get-window.sh). Toak executes this script via Process.Start and appends the stdout result to the LLM prompt.
• Rationale: Avoids bloating the tool with integrations for dozens of display managers and window managers. Users write their own one-liners (hyprctl activewindow, xprop, etc.), keeping Toak lean.

3. In-Place Editing via Primary Selection

Transform Toak from a pure dictation tool into an inline text-editing copilot by reading the Linux "Primary" clipboard (currently highlighted text).

• Implementation: Before sending the prompt to the LLM, attempt to read the primary selection via wl-paste -p (Wayland) or xclip -o -selection primary (X11). If text exists, pass it to the LLM as context alongside the dictated audio.
• Rationale: Allows users to highlight a paragraph, hit the dictation key, and say "Translate this to Spanish" or "Make this sound more professional," replacing the highlighted text via the typing backend.