The ccmd module caches the stdout of commands for a specified duration, preventing unnecessary re-execution of slow or resource-intensive processes.
When to Activate
- When performing repeated network requests (e.g.,
curl). - When running slow diagnostic tools or complex file system searches.
- When a user wants to maintain a "snapshot" of a command's output for a period.
Core Principles & Rules
- Duration Format: Supports time units like
s,m,h,d,w(e.g.,1hfor one hour). Default is1d. - Command Separation: The
--separator is mandatory when providing the command to be executed. - Cache Management: Use
invalidateto force a refresh orclearto remove all cached data.
Patterns & Examples
Cache HTTP Request
# Cache the result of a curl command for 1 hour
x ccmd 1h -- curl https://api.example.com/data
Cache Local Query
# Cache a geographical IP lookup for 30 minutes
x ccmd 30m -- x ips geo 1.1.1.1
Force Refresh
# Clear the cache for a specific command to ensure next run is live
x ccmd invalidate curl
Checklist
- Confirm the desired cache duration.
- Ensure the
--separator is correctly placed. - Verify if the command output is suitable for caching (i.e., not real-time sensitive).