🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Bookmark Keeper

by @ckchzh

Save, organize, and search web bookmarks with tags and categories. Use when collecting research links, organizing lists, or reviewing resources.

Versionv2.0.1
Downloads578
Installs1
TERMINAL
clawhub install bookmark-keeper

πŸ“– About This Skill


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 | Add a new bookmark or item. Without args, shows recent add entries | | bookmark-keeper plan | Record a plan or goal. Without args, shows recent plans | | bookmark-keeper track | Track progress on an item. Without args, shows recent tracking entries | | bookmark-keeper review | Log a review or assessment. Without args, shows recent reviews | | bookmark-keeper streak | Record a streak or consistency milestone. Without args, shows recent streaks | | bookmark-keeper remind | Set a reminder note. Without args, shows recent reminders | | bookmark-keeper prioritize | Record a prioritization decision. Without args, shows recent priorities | | bookmark-keeper archive | Archive a completed or inactive item. Without args, shows recent archives | | bookmark-keeper tag | Add tags or categorize an item. Without args, shows recent tag entries | | bookmark-keeper timeline | Record a timeline entry or milestone. Without args, shows recent timeline entries | | bookmark-keeper report | Generate and log a report. Without args, shows recent reports | | bookmark-keeper weekly-review | Record a weekly review summary. Without args, shows recent weekly reviews | | bookmark-keeper stats | Show summary statistics across all entry types | | bookmark-keeper search | 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 | 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| 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
  • Works offline β€” all data stays on your machine
  • When to Use

    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 streak 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

    # Add bookmarks with notes
    bookmark-keeper add "https://example.com/rust-guide β€” comprehensive Rust tutorial"
    bookmark-keeper add "https://arxiv.org/abs/2401.12345 β€” 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 to find specific entries, or bookmark-keeper export to extract all data as JSON, CSV, or plain text.


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

    ⚑ When to Use

    TriggerAction
    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 `streak`
    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

    # Add bookmarks with notes
    bookmark-keeper add "https://example.com/rust-guide β€” comprehensive Rust tutorial"
    bookmark-keeper add "https://arxiv.org/abs/2401.12345 β€” 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