Labor Law

A multi-purpose utility tool for managing data entries from the command line. Run tasks, manage configurations, track items, search entries, and export data — with full activity logging and history.

Commands

Data Storage

All data is stored in $DATA_DIR/data.log as plain text with date-prefixed entries. Activity history is logged to $DATA_DIR/history.log with timestamps. The default data directory is ~/.local/share/labor-law/. Override it by setting the LABOR_LAW_DIR environment variable, or it will respect XDG_DATA_HOME if set.

Requirements

• Bash 4+ with standard Unix utilities (date, grep, cat)
• No external dependencies or API keys required
• Works on any Linux/macOS terminal

When to Use

1. Quick data tracking — Use labor-law add <entry> to log items with automatic timestamps, then labor-law list to review everything you've recorded.
2. Searching past entries — Run labor-law search <term> to find specific entries in your data log using case-insensitive matching.
3. Initializing a new workspace — Use labor-law init to set up the data directory, then labor-law config to verify the configuration path.
4. Checking system readiness — Run labor-law status for a quick confirmation that the tool is ready and operational.
5. Exporting data for external use — Use labor-law export to dump all logged data to stdout, which you can redirect to a file or pipe to another tool.

Examples

# Initialize the data directory
labor-law init

# Add entries to the data log
labor-law add "Review employment contract for new hire"
labor-law add "Check overtime policy compliance"
labor-law add "Prepare severance calculation"

# List all entries
labor-law list

# Search for specific entries
labor-law search "overtime"

# Check status
labor-law status

# View configuration path
labor-law config

# Show version and data directory
labor-law info

# Export all data
labor-law export > backup.txt

# Run a task
labor-law run "quarterly review"

# Remove an entry
labor-law remove "old item"

How It Works