Skip to content

rafctl v0.4.0 - Sessions, HUD, Polish

Choose a tag to compare

@salacoste salacoste released this 07 Jan 21:54
· 6 commits to main since this release

What's New

Session Monitoring (Epic 14)

  • rafctl sessions command to list recent sessions with duration, messages, tools, errors
  • rafctl sessions <id> for detailed session breakdown with tool usage stats
  • rafctl sessions --today to filter today's sessions only
  • rafctl watch for live real-time session monitoring with file tailing
  • Agent/Task call tracking with subagent types and durations

Native Rust HUD Plugin (Epic 15)

  • rafctl-hud standalone binary implementing Claude Code's statusLine protocol
  • Profile-aware display showing active rafctl profile in statusline
  • Context window percentage with color-coded progress bar (green/yellow/red)
  • Git branch, session duration, tool/agent counts display
  • rafctl hud install [profile] to configure HUD for a profile
  • rafctl hud uninstall to remove HUD configuration
  • rafctl hud status to check HUD installation status
  • Zero external dependencies (no Node.js required)

Polish & Hardening (Epic 16)

  • Security: API key input now hidden (uses rpassword to mask input)
  • Reliability: API requests use 30-second timeout
  • Reliability: Global config uses atomic writes (prevents corruption)
  • UX: New --yes / -y flag for profile remove to skip confirmation
  • UX: Confirmation prompt before removing profiles (safety feature)
  • Errors: New ProcessSpawn and NoDefaultProfile error variants
  • Code: Refactored handle_run with extracted helper functions
  • Code: New core::constants module for centralized configuration

Technical

  • Added notify crate for filesystem watching (live session monitor)
  • Separate binary target for rafctl-hud (src/bin/rafctl-hud.rs)
  • New hud module with stdin protocol parser and renderer
  • New core::transcript module for parsing Claude Code JSONL transcripts

Install

# From source
cargo install --git https://github.com/salacoste/rafctl

# Or download binaries from Assets below

Full Changelog: v0.3.0...v0.4.0