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

# Record a new run entry
design-tool run "updated homepage wireframe v3"

# View recent run entries (no args = show history)
design-tool run

# Check something and log it
design-tool check "color contrast passes WCAG AA"

# Analyze and record
design-tool analyze "user flow has 5 steps, target is 3"

# Preview and record
design-tool preview "mobile layout at 375px"

# Compare designs
design-tool compare "v2 vs v3 header layout"

# Search across all logs
design-tool search "wireframe"

# View summary statistics
design-tool stats