91 lines
2.3 KiB
Markdown
91 lines
2.3 KiB
Markdown
---
|
|
name: bookmark
|
|
description: Manage a personal reading list. Use when the user wants to save, list, mark as read, or remove article URLs for later reading. Triggers on "bookmark", "save URL", "read later", "reading list", "bookmarks".
|
|
---
|
|
|
|
# Bookmark
|
|
|
|
Manage a personal reading list stored in SQLite (`db/bookmark.sqlite`).
|
|
|
|
## Commands
|
|
|
|
All commands run via:
|
|
```bash
|
|
/home/nanobot/.local/bin/uv run /home/nanobot/.nanobot/workspace/skills/bookmark/scripts/bookmark.py <command> [args]
|
|
```
|
|
|
|
### Add a bookmark
|
|
|
|
```bash
|
|
bookmark.py add <url> "<description>" [--tags tag1,tag2]
|
|
```
|
|
|
|
- `url` — the article URL
|
|
- `description` — short human-readable description (required)
|
|
- `--tags` — optional comma-separated tags
|
|
|
|
Example:
|
|
```bash
|
|
bookmark.py add "https://example.com/rust-async" "Async Rust patterns" --tags rust,async
|
|
```
|
|
|
|
### List unread bookmarks
|
|
|
|
```bash
|
|
bookmark.py list [--tag <tag>]
|
|
```
|
|
|
|
Shows ID, URL, tags, description, and date added for each unread bookmark. Use `--tag` to filter.
|
|
|
|
### Mark as read
|
|
|
|
```bash
|
|
bookmark.py read <id>
|
|
```
|
|
|
|
Marks bookmark as read (stores `read_at` timestamp). Does **not** delete — entry stays in DB.
|
|
|
|
### Unmark (mark as unread again)
|
|
|
|
```bash
|
|
bookmark.py unread <id>
|
|
```
|
|
|
|
### Show bookmark details
|
|
|
|
```bash
|
|
bookmark.py show <id>
|
|
```
|
|
|
|
Shows full URL, description, tags, status (read/unread), and dates. Does **not** change any state.
|
|
|
|
### List read bookmarks (history)
|
|
|
|
```bash
|
|
bookmark.py history
|
|
```
|
|
|
|
Shows all bookmarks marked as read, with both `added` and `read` dates.
|
|
|
|
## Output formatting
|
|
|
|
When presenting bookmark lists or details to the user, **always use markdown links** so URLs are clickable in WebUI and Telegram:
|
|
|
|
```
|
|
#3 [hackaday.com](https://hackaday.com/2026/06/02/linux-fu-taming-strace/) [linux, strace] — lepší strace
|
|
```
|
|
|
|
Format: `#<id> [<domain>](<url>) [<tags>] — <description>`
|
|
|
|
- Domain is clickable, pointing to the full URL
|
|
- Tags in brackets, comma-separated
|
|
- Description after em-dash
|
|
- **Never** strip URLs from the output or replace them with plain-text summaries
|
|
|
|
## Workflow
|
|
|
|
1. User shares a URL → `add` with description and optional tags
|
|
2. User wants to see what to read → `list`
|
|
3. User wants to see details of a bookmark → `show <id>`
|
|
4. User finishes an article → `read <id>`
|
|
5. User wants to revisit → `unread <id>` or `history` |