Caption

Caption is a content toolkit for drafting, editing, optimizing, and managing written content directly from the terminal. It tracks every entry with timestamps and supports searching, exporting, and reviewing your content history.

Commands

How It Works

Caption organizes content into separate log files by category (e.g., draft.log, hooks.log, tone.log). Each entry is timestamped and appended to the appropriate log. Running a command without arguments shows the 20 most recent entries for that category.

All actions are also recorded in history.log for a unified activity timeline.

Data Storage

All data is stored locally in ~/.local/share/caption/ by default:

• draft.log, edit.log, optimize.log, etc. — Category-specific entry logs
• history.log — Unified timestamped activity log
• export.json, export.csv, export.txt — Generated export files

Each log entry uses the format: YYYY-MM-DD HH:MM|<content>

Requirements

• bash 4+ (uses set -euo pipefail for strict mode)
• Standard Unix tools (grep, wc, du, tail, head)
• No API keys needed
• No external dependencies

When to Use

1. Drafting social media captions — Use caption draft to quickly log caption ideas as they come to you, then review with caption draft (no args)
2. Managing hashtag collections — Save curated hashtag sets with caption hashtags and search them later with caption search
3. Content optimization workflow — Chain caption draft → caption edit → caption optimize → caption rewrite to track your content refinement pipeline
4. Scheduling and planning posts — Use caption schedule to log planned publication dates alongside content
5. Exporting content for other tools — Run caption export json to get structured data for import into social media schedulers or CMS platforms

Examples

# Draft a new caption
caption draft "Exploring the hidden trails of Hangzhou 🌿 #nature #hiking"

# View recent drafts
caption draft

# Save a set of hashtags
caption hashtags "#tech #ai #machinelearning #coding #devlife"

# Write a call-to-action
caption cta "Drop a 🔥 if you agree — link in bio for more!"

# Search for anything mentioning "hiking"
caption search hiking

# Export everything as JSON
caption export json

# Export as CSV for spreadsheet analysis
caption export csv

# Check overall stats
caption stats

# Save a headline variation
caption headline "10 Things I Wish I Knew About Content Creation"

# Save a content outline
caption outline "Intro → Problem → 3 Tips → CTA → Outro"

# Adjust tone
caption tone "More casual and conversational version of the launch post"

# View recent activity across all categories
caption recent

# Health check
caption status

Output

All command output goes to stdout. Export files are saved to the data directory. Redirect output as needed:

caption stats > content-report.txt

Configuration

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com