Merge pull request #30 from kristoferlund/dev

Author: kristoferlund

CHANGELOG.md

@@ -7,10 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **Output mode configuration** - Control transcription output destination with CLI flags:
+  - Default: outputs to stdout for piping to other commands
+  - `-c` flag: copy to clipboard
+  - `-o <file>` flag: write to file
+- **Top-level record options** - `-c` and `-o` flags now available at CLI top level without explicit `record` command (e.g., `ostt -c` equivalent to `ostt record -c`)
+- **Automatic log rotation** - Log files kept for 7 most recent days; older logs automatically deleted on startup
+- **Version tracking and auto-updates** - Application version tracked in config; app-managed files (float script, Alacritty config) automatically updated on version changes
+- **Retry command** - Re-transcribe previous recordings without re-recording audio (`ostt retry` or `ostt retry N`)
+- **Replay command** - Playback previous recordings using system audio player (`ostt replay` or `ostt replay N`)
+- **Recording history** - Maintains history of 10 most recent audio recordings with automatic rotation
+- **Command aliases** - Short aliases for common commands: `r` (record), `a` (auth), `h` (history), `k` (keywords), `c` (config), `rp` (replay)
+- **Rich help system** - Two-tier help with `-h` (short) and `--help` (long with examples)
+- **Improved error messages** - Typo suggestions and better command-not-found errors
+- **Shell completions** - Generate completion scripts for bash, zsh, fish, and PowerShell (`ostt completions <shell>`)
+
+### Changed
+
+- **CLI framework migration** - Migrated from manual argument parsing to clap for better UX and maintainability
+- `ostt record` now outputs to stdout by default (enables shell piping) instead of clipboard
+- **Audio player priority on Linux** - Replay command now prefers mpv for better user experience (falls back to vlc, ffplay, paplay, xdg-open)
+- **Hyprland window rules syntax** - Updated to new Hyprland window rule syntax with dynamic expressions and `match:` patterns (BREAKING CHANGE)
+- **Float script defaults to clipboard** - `ostt-float.sh` now defaults to `-c` (clipboard) if no arguments provided; existing Hyprland configs continue to work
+- **BREAKING CHANGE for Hyprland/macOS popup users**: Default output changed to stdout. Update your integration scripts to add `-c` flag for clipboard output. See upgrade guides:
+  - [Hyprland Upgrade Guide](environments/hyprland/README.md#upgrading-from-005)
+  - [macOS Upgrade Guide](environments/macOS/README.md#upgrading-from-005)
+
 ### Fixed
 
 - Transcribed text no longer includes leading/trailing whitespace added by transcription models
-- Code quality improvements: fixed format string linting issues
+- Log rotation now properly removes old log files (previously accumulated indefinitely)
 
 ## [0.0.5] - 2025-12-27
 

Cargo.lock

@@ -17,6 +17,10 @@ console = "0.15.8"
 ctrlc = "3.5.1"
 tui-input = "0.14.0"
 
+# CLI argument parsing
+clap = { version = "4.5", features = ["derive"] }
+clap_complete = "4.5"
+
 # Audio capture and processing
 cpal = "0.16.0"
 hound = "3.5.1"
@@ -30,6 +34,7 @@ serde = { version = "1.0.228", features = ["derive"] }
 toml = "0.8.12"
 dirs = "6.0.0"
 anyhow = "1.0.86"
+regex = "1.10"
 
 # Logging
 tracing = "0.1.40"

Cargo.toml

@@ -28,7 +28,7 @@ ostt/
 ### 1. Shell Installer (Linux/macOS) - Recommended
 
 ```bash
-curl --proto '=https' --tlsv1.2 -LsSf https://github.com/kristoferlund/ostt/releases/download/v0.0.1/ostt-installer.sh | sh
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/kristoferlund/ostt/releases/latest/download/ostt-installer.sh | sh
 ```
 
 Then configure:
@@ -164,13 +164,21 @@ On first run, ostt automatically:
 
 ### Hyprland Integration
 
-If you're using Hyprland, add a keybinding to your Hyprland config after first run:
+If you're using Hyprland, add a keybinding and window rules to your Hyprland config after first run:
 
-```bash
-bind = $mainMod, R, exec, ~/.local/bin/ostt-float
+```hyprland
+# Keybinding for ostt (clipboard output)
+bindd = SUPER, R, ostt, exec, bash ~/.local/bin/ostt-float -c
+
+# OSTT window rules
+windowrule = float on, match:title ostt
+windowrule = size (monitor_w*0.14) (monitor_h*0.08), match:title ostt
+windowrule = move ((monitor_w*0.5)-(window_w*0.5)) (monitor_h*0.9), match:title ostt
 ```
 
-This will launch ostt in a floating Alacritty terminal window.
+Then reload your Hyprland configuration: `hyprctl reload`
+
+This will launch ostt in a floating Alacritty terminal window, centered horizontally and positioned at the bottom of the screen.
 
 ## Distribution Details