Instagram Caption
A content creation toolkit for Instagram workflows. Draft captions, edit text, optimize posts, schedule content, generate hashtags, write hooks, create CTAs, rewrite copy, translate captions, adjust tone, craft headlines, and build outlines — all logged with timestamps and exportable in multiple formats.
Commands
| Command |
Description |
draft [input] |
Draft a new caption or content idea. Without input, shows the 20 most recent draft entries |
edit [input] |
Log an edit or revision to existing content. Without input, shows recent edits |
optimize [input] |
Log an optimization note (e.g., engagement improvements). Without input, shows recent entries |
schedule [input] |
Log a scheduling entry (e.g., post date/time). Without input, shows recent schedule entries |
hashtags [input] |
Log hashtag sets for posts. Without input, shows recent hashtag entries |
hooks [input] |
Log attention-grabbing opening hooks. Without input, shows recent hooks |
cta [input] |
Log call-to-action text. Without input, shows recent CTAs |
rewrite [input] |
Log a content rewrite or alternative version. Without input, shows recent rewrites |
translate [input] |
Log a translation of caption content. Without input, shows recent translations |
tone [input] |
Log a tone adjustment note (e.g., casual, professional). Without input, shows recent tone entries |
headline [input] |
Log a headline or title idea. Without input, shows recent headlines |
outline [input] |
Log a content outline or structure. Without input, shows recent outlines |
stats |
Show summary statistics — entry counts per category, total entries, data size, and first activity date |
export <fmt> |
Export all data to a file in json, csv, or txt format |
search <term> |
Search across all content categories for a keyword or phrase |
recent |
Show the 20 most recent history entries across all categories |
status |
Health check — version, data dir, total entries, disk usage, last activity |
help |
Show all available commands |
version |
Display current version (v2.0.0) |
Data Storage
- Data directory:
~/.local/share/instagram-caption/
- Category logs: Each command stores entries in its own log file (e.g.,
draft.log, hashtags.log, schedule.log)
- History log:
history.log — unified timeline of all activity with timestamps
- Export files:
export.json, export.csv, or export.txt generated on demand
- All data is stored locally in plain text; no Instagram API access or external accounts required
Requirements
- Bash 4+ (uses
set -euo pipefail)
- Standard POSIX utilities (
date, wc, du, grep, tail, head, cat)
- No API keys, no Instagram login, no external dependencies
When to Use
- Brainstorming caption ideas — use
draft to quickly log caption concepts as they come to mind, then review them later before posting
- Building a hashtag library — use
hashtags to save curated hashtag sets for different content themes, then search them with search
- Content planning and scheduling — use
schedule to log planned post dates and outline to structure upcoming content series
- A/B testing copy — use
rewrite to log alternative versions of the same caption, then compare performance notes later
- Multi-language content — use
translate to log translated versions of captions for international audiences, with tone adjustments per locale
Examples
# Draft a new caption idea
instagram-caption draft "Golden hour vibes ☀️ — chasing light and good energy"
# Save a hashtag set for travel content
instagram-caption hashtags "#travel #wanderlust #explore #adventure #travelgram"
# Log a scheduled post
instagram-caption schedule "March 20, 6:00 PM — carousel post about productivity tips"
# Write a hook for a reel
instagram-caption hooks "Stop scrolling — this 3-second trick will change your morning routine"
# Export all content data to JSON
instagram-caption export json
Example Output
$ instagram-caption draft "Sunday reset routine ✨"
[Instagram Caption] draft: Sunday reset routine ✨
Saved. Total draft entries: 15
$ instagram-caption stats
=== Instagram Caption Stats ===
draft: 15 entries
hashtags: 8 entries
hooks: 6 entries
schedule: 12 entries
---
Total: 41 entries
Data size: 24K
Since: 03-10 14:30
$ instagram-caption status
=== Instagram Caption Status ===
Version: v2.0.0
Data dir: /home/user/.local/share/instagram-caption
Entries: 41 total
Disk: 24K
Last activity: 03-18 11:22 draft: Sunday reset routine ✨
Status: OK
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: instagram-caption3description: Instagram文案、精准Hashtag(30个)、Story脚本、Reels脚本、简介优化、内容日历。Instagram caption writer with hashtags, Story scripts, Reels scripts, bio optimization.4---5# Instagram Caption
6
7A content creation toolkit for Instagram workflows. Draft captions, edit text, optimize posts, schedule content, generate hashtags, write hooks, create CTAs, rewrite copy, translate captions, adjust tone, craft headlines, and build outlines — all logged with timestamps and exportable in multiple formats.
8
9## Commands
10
11| Command | Description |
12|---------|-------------|
13| `draft [input]` | Draft a new caption or content idea. Without input, shows the 20 most recent draft entries |
14| `edit [input]` | Log an edit or revision to existing content. Without input, shows recent edits |
15| `optimize [input]` | Log an optimization note (e.g., engagement improvements). Without input, shows recent entries |
16| `schedule [input]` | Log a scheduling entry (e.g., post date/time). Without input, shows recent schedule entries |
17| `hashtags [input]` | Log hashtag sets for posts. Without input, shows recent hashtag entries |
18| `hooks [input]` | Log attention-grabbing opening hooks. Without input, shows recent hooks |
19| `cta [input]` | Log call-to-action text. Without input, shows recent CTAs |
20| `rewrite [input]` | Log a content rewrite or alternative version. Without input, shows recent rewrites |
21| `translate [input]` | Log a translation of caption content. Without input, shows recent translations |
22| `tone [input]` | Log a tone adjustment note (e.g., casual, professional). Without input, shows recent tone entries |
23| `headline [input]` | Log a headline or title idea. Without input, shows recent headlines |
24| `outline [input]` | Log a content outline or structure. Without input, shows recent outlines |
25| `stats` | Show summary statistics — entry counts per category, total entries, data size, and first activity date |
26| `export <fmt>` | Export all data to a file in `json`, `csv`, or `txt` format |
27| `search <term>` | Search across all content categories for a keyword or phrase |
28| `recent` | Show the 20 most recent history entries across all categories |
29| `status` | Health check — version, data dir, total entries, disk usage, last activity |
30| `help` | Show all available commands |
31| `version` | Display current version (v2.0.0) |
32
33## Data Storage
34
35- **Data directory:** `~/.local/share/instagram-caption/`
36- **Category logs:** Each command stores entries in its own log file (e.g., `draft.log`, `hashtags.log`, `schedule.log`)
37- **History log:** `history.log` — unified timeline of all activity with timestamps
38- **Export files:** `export.json`, `export.csv`, or `export.txt` generated on demand
39- All data is stored locally in plain text; no Instagram API access or external accounts required
40
41## Requirements
42
43- Bash 4+ (uses `set -euo pipefail`)
44- Standard POSIX utilities (`date`, `wc`, `du`, `grep`, `tail`, `head`, `cat`)
45- No API keys, no Instagram login, no external dependencies
46
47## When to Use
48
491. **Brainstorming caption ideas** — use `draft` to quickly log caption concepts as they come to mind, then review them later before posting
502. **Building a hashtag library** — use `hashtags` to save curated hashtag sets for different content themes, then search them with `search`
513. **Content planning and scheduling** — use `schedule` to log planned post dates and `outline` to structure upcoming content series
524. **A/B testing copy** — use `rewrite` to log alternative versions of the same caption, then `compare` performance notes later
535. **Multi-language content** — use `translate` to log translated versions of captions for international audiences, with `tone` adjustments per locale
54
55## Examples
56
57```bash
58# Draft a new caption idea
59instagram-caption draft "Golden hour vibes ☀️ — chasing light and good energy"
60
61# Save a hashtag set for travel content
62instagram-caption hashtags "#travel #wanderlust #explore #adventure #travelgram"
63
64# Log a scheduled post
65instagram-caption schedule "March 20, 6:00 PM — carousel post about productivity tips"
66
67# Write a hook for a reel
68instagram-caption hooks "Stop scrolling — this 3-second trick will change your morning routine"
69
70# Export all content data to JSON
71instagram-caption export json
72```
73
74### Example Output
75
76```
77$ instagram-caption draft "Sunday reset routine ✨"
78 [Instagram Caption] draft: Sunday reset routine ✨
79 Saved. Total draft entries: 15
80
81$ instagram-caption stats
82=== Instagram Caption Stats ===
83 draft: 15 entries
84 hashtags: 8 entries
85 hooks: 6 entries
86 schedule: 12 entries
87 ---
88 Total: 41 entries
89 Data size: 24K
90 Since: 03-10 14:30
91
92$ instagram-caption status
93=== Instagram Caption Status ===
94 Version: v2.0.0
95 Data dir: /home/user/.local/share/instagram-caption
96 Entries: 41 total
97 Disk: 24K
98 Last activity: 03-18 11:22 draft: Sunday reset routine ✨
99 Status: OK
100```
101
102---
103
104Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
bytesagain