Bookmark Keeper

A productivity toolkit for managing bookmarks, plans, tasks, and reviews — all from the command line with timestamped local logging, tagging, archiving, and weekly review workflows.

Commands

Each command (add, plan, track, etc.) works the same way:

• - With arguments: saves the entry with a timestamp to its dedicated .log file and records it in activity history
• Without arguments: displays the 20 most recent entries from that command's log

Data Storage

All data is stored locally in plain-text log files:

CODEBLOCK0

Each entry is stored as YYYY-MM-DD HH:MM|<value> for easy parsing and export.

Requirements

• - Bash 4.0+ (uses set -euo pipefail)
• Standard UNIX utilities: date, wc, du, grep, head, tail, INLINECODE28
• No external dependencies or API keys required
• Works offline — all data stays on your machine

When to Use

1. 1. Research link collection — Use add to save URLs with notes as you research a topic, then tag to categorize them and search to find them later
2. Weekly productivity reviews — Run weekly-review every Sunday to summarize what you accomplished, what's pending, and what to focus on next week
3. Goal tracking with streaks — Set goals with plan, track daily progress with track, and celebrate consistency milestones with INLINECODE35
4. Reading list management — Add articles and resources with add, prioritize what to read next, and archive items once consumed
5. Project milestone tracking — Use timeline to record key milestones, report to generate progress summaries, and remind to set follow-up notes

Examples

Build a bookmark collection

CODEBLOCK1

Weekly review workflow

CODEBLOCK2

Plan, remind, and archive

CODEBLOCK3

Export and status

CODEBLOCK4

Output

All commands print confirmation to stdout. Data is persisted in ~/.local/share/bookmark-keeper/. Use bookmark-keeper stats for an overview, bookmark-keeper search <term> to find specific entries, or bookmark-keeper export <fmt> to extract all data as JSON, CSV, or plain text.