| version | 2.0.0 |
| name | bookmark-keeper |
| description | Save, organize, and search web bookmarks with tags and categories. Use when collecting research links, organizing lists, or reviewing resources. |
| author | BytesAgain |
| homepage | https://bytesagain.com |
| source | https://github.com/bytesagain/ai-skills |
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
bookmark-keeper add "[Technical Reference] — thorough Rust tutorial"
bookmark-keeper add "[Technical Reference] — attention mechanisms survey paper"
bookmark-keeper tag "rust-guide: #programming #rust #tutorial"
bookmark-keeper tag "attention-paper: #ml #research #papers"
bookmark-keeper search "rust"
bookmark-keeper prioritize "rust-guide — high priority, needed for current project"
Weekly review workflow
bookmark-keeper track "completed 3 chapters of Rust book, built first CLI tool"
bookmark-keeper track "reviewed 5 research papers, summarized key findings"
bookmark-keeper streak "day 14 of daily coding practice"
bookmark-keeper weekly-review "Week 12: finished Rust basics, started async chapter. Read 5 papers. Next week: build REST API in Rust."
bookmark-keeper report "March progress: 20 bookmarks added, 12 reviewed, 8 archived"
Plan, remind, and archive
bookmark-keeper plan "Q2 reading goal: 15 technical articles, 3 books"
bookmark-keeper remind "follow up on ML paper discussion — Friday"
bookmark-keeper timeline "2024-04-01: started Rust learning path"
bookmark-keeper archive "rust-guide — completed, notes saved to wiki"
bookmark-keeper stats
bookmark-keeper recent
Export and status
bookmark-keeper export json
bookmark-keeper export csv
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
