Design Tool

Design Tool v2.0.0 — a utility toolkit for logging, tracking, and managing design-related entries from the command line.

Commands

All commands accept optional input arguments. Without arguments, they display recent entries from the corresponding log. With arguments, they record a new timestamped entry.

Data Storage

All data is stored locally in ~/.local/share/design-tool/:

• - Per-command logs — Each command (run, check, convert, etc.) writes to its own .log file with pipe-delimited timestamp|value format.
• history.log — A unified activity log recording every write operation with timestamps.
• Export formats — The export utility function supports JSON, CSV, and TXT output, written to ~/.local/share/design-tool/export.<fmt>.

No external services, databases, or API keys are required. Everything is flat-file and human-readable.

Requirements

• - Bash (v4+ recommended)
• No external dependencies — uses only standard Unix utilities (date, wc, du, tail, grep, sed, basename, cat)

When to Use

• - When you need to log and track design-related activities from the command line
• To maintain a searchable history of design decisions and iterations
• For batch recording of design tasks with timestamps
• When you want to export design logs in JSON, CSV, or TXT format
• As part of a larger design workflow automation pipeline
• To get quick statistics and summaries of past design activities

Examples

CODEBLOCK0

How It Works

Each command follows the same pattern:

1. 1. With arguments — Timestamps the input, appends it to the command-specific log file, prints confirmation, and logs to history.log.
2. Without arguments — Shows the last 20 entries from that command's log file.

The stats command iterates all .log files, counts entries per file, and reports totals plus disk usage. The search command performs case-insensitive grep across all log files. The recent command tails the last 20 lines of history.log.