ERP

Enterprise resource planning productivity toolkit (v2.0.0). Log and track business activities across multiple categories — planning, tracking, reviews, reminders, priorities, archiving, tagging, timelines, reports, and weekly reviews. Each command records timestamped entries to its own log file, giving you a complete audit trail of all business operations.

Commands

Command	Description
`erp add <input>`	Add a new entry to the general log. Without args, shows recent entries.
`erp plan <input>`	Record a planning note (resource allocation, project plan, etc.). Without args, shows recent plan entries.
`erp track <input>`	Track an activity, metric, or progress item. Without args, shows recent tracked entries.
`erp review <input>`	Log a review note (performance review, process review, etc.). Without args, shows recent reviews.
`erp streak <input>`	Record a streak milestone or daily streak entry. Without args, shows recent streaks.
`erp remind <input>`	Set a reminder or note something to follow up on. Without args, shows recent reminders.
`erp prioritize <input>`	Log a prioritization decision or rank items. Without args, shows recent priorities.
`erp archive <input>`	Archive a completed item or record. Without args, shows recent archived entries.
`erp tag <input>`	Tag or categorize an entry. Without args, shows recent tags.
`erp timeline <input>`	Add an event to the timeline. Without args, shows recent timeline entries.
`erp report <input>`	Log a report or summary. Without args, shows recent reports.
`erp weekly-review <input>`	Record a weekly review summary. Without args, shows recent weekly reviews.
`erp stats`	Show summary statistics: entry counts per category, total entries, data size, and earliest record date.
`erp export <fmt>`	Export all data to a file. Supported formats: `json`, `csv`, `txt`.
`erp search <term>`	Search across all log files for a keyword (case-insensitive).
`erp recent`	Show the 20 most recent entries from the activity history log.
`erp status`	Health check: version, data directory, total entries, disk usage, last activity.
`erp help`	Show the built-in help with all available commands.
`erp version`	Print the current version (v2.0.0).

Data Storage

All data is stored as plain-text log files in ~/.local/share/erp/:

Per-command logs — Each command (add, plan, track, etc.) writes to its own .log file (e.g., add.log, plan.log).
History log — Every operation is also appended to history.log with a timestamp and command name.
Export files — Generated in the same directory as export.json, export.csv, or export.txt.

Entries are stored in timestamp|value format, making them easy to grep, parse, or pipe into other tools.

Requirements

Bash 4.0+ (uses set -euo pipefail)
coreutils — date, wc, du, head, tail, grep, basename, cut
No external dependencies, API keys, or network access required
Works fully offline on any POSIX-compatible system

When to Use

Daily operational logging — Track what happened across departments each day: sales calls, support tickets resolved, inventory received, tasks completed.
Resource planning and prioritization — Use plan and prioritize to record allocation decisions and rank items by importance before committing resources.
Weekly business reviews — Run weekly-review to summarize the week, then stats to see aggregate numbers and export json to share with stakeholders.
Reminder and follow-up management — Use remind to note items that need attention later, and search to quickly find past reminders by keyword.
Audit trail and compliance — Every action is timestamped and logged to history.log, providing a complete chronological record of all ERP activities for auditing purposes.

Examples

# Add a new inventory item
erp add "Received 500 units of Widget-A from Supplier-X"

# Plan resource allocation for Q2
erp plan "Allocate 3 engineers to Project Alpha for Q2"

# Track a KPI
erp track "Customer satisfaction score: 4.7/5.0"

# Set a priority
erp prioritize "Ship feature-X before feature-Y — customer deadline March 30"

# Record a weekly review
erp weekly-review "Week 12: shipped 3 features, resolved 15 tickets, revenue +8%"

# Search for anything mentioning 'Widget'
erp search Widget

# Export everything to JSON for reporting
erp export json

# Check system health
erp status

# View summary statistics
erp stats

Tips

Run any data command without arguments to see recent entries (e.g., erp add shows the last 20 add entries).
Use erp recent for a quick overview of all activity across all categories.
Pipe exports to other tools: cat ~/.local/share/erp/export.csv | column -t -s,
Back up your data by copying ~/.local/share/erp/ to your preferred backup location.