Standardizes persistent state, configuration, and log management for Bash scripts using XDG specifications.
The State Directory Manager provides a robust framework for Bash scripts to handle persistent data reliably across Linux and macOS. It implements the XDG Base Directory specification to ensure scripts store configuration, cache, and state files in standardized locations, preventing home directory clutter. With built-in support for key-value configuration, JSON state tracking, TTL-based caching, and automated log rotation, this skill enables developers to build production-grade CLI tools and automation scripts with minimal boilerplate and maximum portability.
Key Features
01Automated log rotation with size limits and historical file cleanup
02XDG Base Directory compliance for standardized file locations
03Cache management with MD5 hashing and Time-To-Live (TTL) expiration
04Key-value configuration management with default value support
05Persistent state tracking using JSON (jq) or simple key-value pairs
063 GitHub stars
Use Cases
01Building automation scripts that need to cache API responses or expensive computations
02Managing application logs and maintenance tasks for server-side bash processes
03Developing portable CLI tools that require user preferences and persistent settings
