🆘 Tips CLI Help File

This document describes how to use tips.sh — a command-line utility for storing and managing tips or notes in a structured format.

📦 Basic Structure

Each record contains the following 12 fields, separated by <>:

ID
Date
Category
SubCategory
SubSubCategory
Title
Description
More Info
Comments
Attachment Path
Link
Tags

⚙️ Usage Syntax

./tips.sh [OPTIONS] [ARGUMENT]

📘 Options Reference

Option	Function	Usage Example
-a	Add a new tip record	`./tips.sh -a`
-u	Update a record by ID	`./tips.sh -u`
-s <term>	Search all fields	`./tips.sh -s docker`
-f <regex>	Fuzzy search using regex	`./tips.sh -f "^curl.*error"`
-T <title>	Search title field only	`./tips.sh -T ssh`
-C <category>	Filter by category	`./tips.sh -C Linux`
-g <tag>	Filter by tag	`./tips.sh -g terminal`
-t <n>	Tail last N records	`./tips.sh -t 5`
-S	Show summary view	`./tips.sh -S`
-G <term>	Search summary view	`./tips.sh -G cron`
-v	Validate all records	`./tips.sh -v`
-J	Convert CSV to JSON	`./tips.sh -J`
-Y	Convert CSV to YAML	`./tips.sh -Y`
-e	Edit CSV file	`./tips.sh -e`
-E	Edit attachment by ID	`./tips.sh -E`

📂 Data File

Default CSV file: tips.csv
Delimiter used: <>
Attachments saved to: tipsAttachments/

💡 Sample Workflow

Create a new tip: ./tips.sh -a
Find tips about cron: ./tips.sh -s cron
Update tip with ID 12: ./tips.sh -u → enter ID 12
Tail last 3 entries: ./tips.sh -t 3
Validate all records: ./tips.sh -v
Export as JSON: ./tips.sh -J

📎 Notes

Records are saved using a timestamp-based date.
Attachments (if added) can be edited later via the -E option.
Functions rely on AWK scripts for formatting and filtering.