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. 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

CODEBLOCK0

How It Works

Labor Law stores all entries locally in ~/.local/share/labor-law/data.log. Each add command prepends the current date to the entry. Every command invocation is logged to history.log with a timestamp for full audit traceability. No data leaves your machine — everything is stored locally in plain text files.

Configuration

Set LABOR_LAW_DIR to change the data directory:

CODEBLOCK1

Default: ~/.local/share/labor-law/