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
| Command |
Description |
bookmark-keeper add <input> |
Add a new bookmark or item. Without args, shows recent add entries |
bookmark-keeper plan <input> |
Record a plan or goal. Without args, shows recent plans |
bookmark-keeper track <input> |
Track progress on an item. Without args, shows recent tracking entries |
bookmark-keeper review <input> |
Log a review or assessment. Without args, shows recent reviews |
bookmark-keeper streak <input> |
Record a streak or consistency milestone. Without args, shows recent streaks |
bookmark-keeper remind <input> |
Set a reminder note. Without args, shows recent reminders |
bookmark-keeper prioritize <input> |
Record a prioritization decision. Without args, shows recent priorities |
bookmark-keeper archive <input> |
Archive a completed or inactive item. Without args, shows recent archives |
bookmark-keeper tag <input> |
Add tags or categorize an item. Without args, shows recent tag entries |
bookmark-keeper timeline <input> |
Record a timeline entry or milestone. Without args, shows recent timeline entries |
bookmark-keeper report <input> |
Generate and log a report. Without args, shows recent reports |
bookmark-keeper weekly-review <input> |
Record a weekly review summary. Without args, shows recent weekly reviews |
bookmark-keeper stats |
Show summary statistics across all entry types |
bookmark-keeper search <term> |
Search across all log entries for a keyword |
bookmark-keeper recent |
Show the 20 most recent activity entries |
bookmark-keeper status |
Health check — version, data dir, entry count, disk usage, last activity |
bookmark-keeper export <fmt> |
Export all data in json, csv, or txt format |
bookmark-keeper help |
Show all available commands |
bookmark-keeper version |
Print version (v2.0.0) |
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:
~/.local/share/bookmark-keeper/
├── add.log # Added bookmarks and items
├── plan.log # Plans and goals
├── track.log # Progress tracking entries
├── review.log # Reviews and assessments
├── streak.log # Streak / consistency records
├── remind.log # Reminder notes
├── prioritize.log # Prioritization decisions
├── archive.log # Archived items
├── tag.log # Tag and categorization entries
├── timeline.log # Timeline milestones
├── report.log # Generated reports
├── weekly-review.log # Weekly review summaries
└── history.log # Unified activity log with timestamps
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, cat
- No external dependencies or API keys required
- Runs without internet — all data stays on your machine
When to Use
- 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
- Weekly productivity reviews — Run
weekly-review every Sunday to summarize what you accomplished, what's pending, and what to focus on next week
- Goal tracking with streaks — Set goals with
plan, track daily progress with track, and celebrate consistency milestones with streak
- Reading list management — Add articles and resources with
add, prioritize what to read next, and archive items once consumed
- 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
# Add bookmarks with notes
bookmark-keeper add "[Technical Reference] — thorough Rust tutorial"
bookmark-keeper add "[Technical Reference] — attention mechanisms survey paper"
# Tag them for organization
bookmark-keeper tag "rust-guide: #programming #rust #tutorial"
bookmark-keeper tag "attention-paper: #ml #research #papers"
# Search later
bookmark-keeper search "rust"
# Prioritize what to read first
bookmark-keeper prioritize "rust-guide — high priority, needed for current project"
Weekly review workflow
# Track daily progress
bookmark-keeper track "completed 3 chapters of Rust book, built first CLI tool"
bookmark-keeper track "reviewed 5 research papers, summarized key findings"
# Record streaks
bookmark-keeper streak "day 14 of daily coding practice"
# Do your weekly review
bookmark-keeper weekly-review "Week 12: finished Rust basics, started async chapter. Read 5 papers. Next week: build REST API in Rust."
# Generate a report
bookmark-keeper report "March progress: 20 bookmarks added, 12 reviewed, 8 archived"
Plan, remind, and archive
# Set a plan
bookmark-keeper plan "Q2 reading goal: 15 technical articles, 3 books"
# Set reminders
bookmark-keeper remind "follow up on ML paper discussion — Friday"
# Record a timeline milestone
bookmark-keeper timeline "2024-04-01: started Rust learning path"
# Archive completed items
bookmark-keeper archive "rust-guide — completed, notes saved to wiki"
# View stats and recent activity
bookmark-keeper stats
bookmark-keeper recent
Export and status
# Export everything as JSON
bookmark-keeper export json
# Export as CSV for spreadsheet analysis
bookmark-keeper export csv
# Health check
bookmark-keeper status
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.
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
1---2name: bookmark-keeper3description: Save, organize, and search web bookmarks with tags and categories. Use when collecting research links, organizing lists, or reviewing resources.4---5
6# Bookmark Keeper
7
8A productivity toolkit for managing bookmarks, plans, tasks, and reviews — all from the command line with timestamped local logging, tagging, archiving, and weekly review workflows.
9
10## Commands
11
12| Command | Description |
13|---------|-------------|
14| `bookmark-keeper add <input>` | Add a new bookmark or item. Without args, shows recent add entries |
15| `bookmark-keeper plan <input>` | Record a plan or goal. Without args, shows recent plans |
16| `bookmark-keeper track <input>` | Track progress on an item. Without args, shows recent tracking entries |
17| `bookmark-keeper review <input>` | Log a review or assessment. Without args, shows recent reviews |
18| `bookmark-keeper streak <input>` | Record a streak or consistency milestone. Without args, shows recent streaks |
19| `bookmark-keeper remind <input>` | Set a reminder note. Without args, shows recent reminders |
20| `bookmark-keeper prioritize <input>` | Record a prioritization decision. Without args, shows recent priorities |
21| `bookmark-keeper archive <input>` | Archive a completed or inactive item. Without args, shows recent archives |
22| `bookmark-keeper tag <input>` | Add tags or categorize an item. Without args, shows recent tag entries |
23| `bookmark-keeper timeline <input>` | Record a timeline entry or milestone. Without args, shows recent timeline entries |
24| `bookmark-keeper report <input>` | Generate and log a report. Without args, shows recent reports |
25| `bookmark-keeper weekly-review <input>` | Record a weekly review summary. Without args, shows recent weekly reviews |
26| `bookmark-keeper stats` | Show summary statistics across all entry types |
27| `bookmark-keeper search <term>` | Search across all log entries for a keyword |
28| `bookmark-keeper recent` | Show the 20 most recent activity entries |
29| `bookmark-keeper status` | Health check — version, data dir, entry count, disk usage, last activity |
30| `bookmark-keeper export <fmt>` | Export all data in json, csv, or txt format |
31| `bookmark-keeper help` | Show all available commands |
32| `bookmark-keeper version` | Print version (v2.0.0) |
33
34Each command (add, plan, track, etc.) works the same way:
35- **With arguments**: saves the entry with a timestamp to its dedicated `.log` file and records it in activity history
36- **Without arguments**: displays the 20 most recent entries from that command's log
37
38## Data Storage
39
40All data is stored locally in plain-text log files:
41
42```
43~/.local/share/bookmark-keeper/
44├── add.log # Added bookmarks and items
45├── plan.log # Plans and goals
46├── track.log # Progress tracking entries
47├── review.log # Reviews and assessments
48├── streak.log # Streak / consistency records
49├── remind.log # Reminder notes
50├── prioritize.log # Prioritization decisions
51├── archive.log # Archived items
52├── tag.log # Tag and categorization entries
53├── timeline.log # Timeline milestones
54├── report.log # Generated reports
55├── weekly-review.log # Weekly review summaries
56└── history.log # Unified activity log with timestamps
57```
58
59Each entry is stored as `YYYY-MM-DD HH:MM|<value>` for easy parsing and export.
60
61## Requirements
62
63- **Bash** 4.0+ (uses `set -euo pipefail`)
64- Standard UNIX utilities: `date`, `wc`, `du`, `grep`, `head`, `tail`, `cat`
65- No external dependencies or API keys required
66- Runs without internet — all data stays on your machine
67
68## When to Use
69
701. **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
712. **Weekly productivity reviews** — Run `weekly-review` every Sunday to summarize what you accomplished, what's pending, and what to focus on next week
723. **Goal tracking with streaks** — Set goals with `plan`, track daily progress with `track`, and celebrate consistency milestones with `streak`
734. **Reading list management** — Add articles and resources with `add`, `prioritize` what to read next, and `archive` items once consumed
745. **Project milestone tracking** — Use `timeline` to record key milestones, `report` to generate progress summaries, and `remind` to set follow-up notes
75
76## Examples
77
78### Build a bookmark collection
79
80```bash
81# Add bookmarks with notes
82bookmark-keeper add "[Technical Reference] — thorough Rust tutorial"
83bookmark-keeper add "[Technical Reference] — attention mechanisms survey paper"
84
85# Tag them for organization
86bookmark-keeper tag "rust-guide: #programming #rust #tutorial"
87bookmark-keeper tag "attention-paper: #ml #research #papers"
88
89# Search later
90bookmark-keeper search "rust"
91
92# Prioritize what to read first
93bookmark-keeper prioritize "rust-guide — high priority, needed for current project"
94```
95
96### Weekly review workflow
97
98```bash
99# Track daily progress
100bookmark-keeper track "completed 3 chapters of Rust book, built first CLI tool"
101bookmark-keeper track "reviewed 5 research papers, summarized key findings"
102
103# Record streaks
104bookmark-keeper streak "day 14 of daily coding practice"
105
106# Do your weekly review
107bookmark-keeper weekly-review "Week 12: finished Rust basics, started async chapter. Read 5 papers. Next week: build REST API in Rust."
108
109# Generate a report
110bookmark-keeper report "March progress: 20 bookmarks added, 12 reviewed, 8 archived"
111```
112
113### Plan, remind, and archive
114
115```bash
116# Set a plan
117bookmark-keeper plan "Q2 reading goal: 15 technical articles, 3 books"
118
119# Set reminders
120bookmark-keeper remind "follow up on ML paper discussion — Friday"
121
122# Record a timeline milestone
123bookmark-keeper timeline "2024-04-01: started Rust learning path"
124
125# Archive completed items
126bookmark-keeper archive "rust-guide — completed, notes saved to wiki"
127
128# View stats and recent activity
129bookmark-keeper stats
130bookmark-keeper recent
131```
132
133### Export and status
134
135```bash
136# Export everything as JSON
137bookmark-keeper export json
138
139# Export as CSV for spreadsheet analysis
140bookmark-keeper export csv
141
142# Health check
143bookmark-keeper status
144```
145
146## Output
147
148All 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.
149
150---
151
152*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*
bytesagain