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.
| Command |
Description |
run <input> |
Record or view run entries |
check <input> |
Record or view check entries |
convert <input> |
Record or view convert entries |
analyze <input> |
Record or view analyze entries |
generate <input> |
Record or view generate entries |
preview <input> |
Record or view preview entries |
batch <input> |
Record or view batch entries |
compare <input> |
Record or view compare entries |
export <input> |
Record or view export entries |
config <input> |
Record or view config entries |
status <input> |
Record or view status entries |
report <input> |
Record or view report entries |
stats |
Show summary statistics across all log files |
search <term> |
Search all log entries for a keyword (case-insensitive) |
recent |
Display the 20 most recent history log entries |
help |
Show usage information |
version |
Print version (v2.0.0) |
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
# Show recent activity across all commands
design-tool recent
# Show tool version
design-tool version
# Show full help
design-tool help
How It Works
Each command follows the same pattern:
- With arguments — Timestamps the input, appends it to the command-specific log file, prints confirmation, and logs to
history.log.
- 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.
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: penpot3description: Penpot: The open-source design tool for design and code collaboration design-tool, clojure, clojure, clojurescript, design, prototyping.4---5
6# Design Tool
7
8Design Tool v2.0.0 — a utility toolkit for logging, tracking, and managing design-related entries from the command line.
9
10## Commands
11
12All commands accept optional input arguments. Without arguments, they display recent entries from the corresponding log. With arguments, they record a new timestamped entry.
13
14| Command | Description |
15|---------|-------------|
16| `run <input>` | Record or view run entries |
17| `check <input>` | Record or view check entries |
18| `convert <input>` | Record or view convert entries |
19| `analyze <input>` | Record or view analyze entries |
20| `generate <input>` | Record or view generate entries |
21| `preview <input>` | Record or view preview entries |
22| `batch <input>` | Record or view batch entries |
23| `compare <input>` | Record or view compare entries |
24| `export <input>` | Record or view export entries |
25| `config <input>` | Record or view config entries |
26| `status <input>` | Record or view status entries |
27| `report <input>` | Record or view report entries |
28| `stats` | Show summary statistics across all log files |
29| `search <term>` | Search all log entries for a keyword (case-insensitive) |
30| `recent` | Display the 20 most recent history log entries |
31| `help` | Show usage information |
32| `version` | Print version (v2.0.0) |
33
34## Data Storage
35
36All data is stored locally in `~/.local/share/design-tool/`:
37
38- **Per-command logs** — Each command (run, check, convert, etc.) writes to its own `.log` file with pipe-delimited `timestamp|value` format.
39- **history.log** — A unified activity log recording every write operation with timestamps.
40- **Export formats** — The `export` utility function supports JSON, CSV, and TXT output, written to `~/.local/share/design-tool/export.<fmt>`.
41
42No external services, databases, or API keys are required. Everything is flat-file and human-readable.
43
44## Requirements
45
46- **Bash** (v4+ recommended)
47- No external dependencies — uses only standard Unix utilities (`date`, `wc`, `du`, `tail`, `grep`, `sed`, `basename`, `cat`)
48
49## When to Use
50
51- When you need to log and track design-related activities from the command line
52- To maintain a searchable history of design decisions and iterations
53- For batch recording of design tasks with timestamps
54- When you want to export design logs in JSON, CSV, or TXT format
55- As part of a larger design workflow automation pipeline
56- To get quick statistics and summaries of past design activities
57
58## Examples
59
60```bash
61# Record a new run entry
62design-tool run "updated homepage wireframe v3"
63
64# View recent run entries (no args = show history)
65design-tool run
66
67# Check something and log it
68design-tool check "color contrast passes WCAG AA"
69
70# Analyze and record
71design-tool analyze "user flow has 5 steps, target is 3"
72
73# Preview and record
74design-tool preview "mobile layout at 375px"
75
76# Compare designs
77design-tool compare "v2 vs v3 header layout"
78
79# Search across all logs
80design-tool search "wireframe"
81
82# View summary statistics
83design-tool stats
84
85# Show recent activity across all commands
86design-tool recent
87
88# Show tool version
89design-tool version
90
91# Show full help
92design-tool help
93```
94
95## How It Works
96
97Each command follows the same pattern:
981. **With arguments** — Timestamps the input, appends it to the command-specific log file, prints confirmation, and logs to `history.log`.
992. **Without arguments** — Shows the last 20 entries from that command's log file.
100
101The `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`.
102
103---
104
105Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
bytesagain