Organizing

Every link has a numeric #id (shown on each result from /recent and /find). The commands below act on a link by its id.

Reading status

Each link starts as unread. Move it through a simple workflow:

/reading <id>     — mark as in-progress
/read <id>        — mark as done
/archive <id>     — tuck away
/unread <id>      — back to the inbox

Favorites

/star <id>        — toggle the ⭐ on a link

Collections

Group links under a free-form name:

/collection <id> <name>     — add link to a collection (e.g. /collection 12 rust)
/collection <id>            — clear its collection (omit the name)

Reminders

Tag a link to resurface on a date:

/remind <id> 2026-06-15     — set a YYYY-MM-DD reminder

Note

/remind stores the date and /due lists what’s due — but the bot does not yet push you a reminder on its own. An automatic daily nudge needs a Cloudflare Cron Trigger and is a planned later addition.

Lists

Filter your library without a keyword search:

/inbox          — unread links
/favorites      — your starred links
/due            — links whose reminder is today or earlier
/in <name>      — everything in a collection (e.g. /in rust)

These reuse the same result cards as /find, so each still shows its #id, status, category, and tags.

Auto-organizing & duplicates

Two commands use the semantic embeddings to tidy your library:

/organize     — cluster similar links and assign suggested collection names
/dupes        — list near-duplicate / heavily-overlapping links to review

• /organize groups links by similarity, has the model name each group (e.g. password-vaults, dev-interviews, cs-fundamentals), and assigns that collection to the uncollected links in each group — it never overwrites a collection you set. Reversible: change any via the command or the dashboard. View a group with /in <name>.
• /dupes lists pairs of links that look like duplicates or strong overlaps (e.g. two Bitwarden servers) with a similarity %. It only reports — you decide whether to delete one (in the dashboard). Exact-URL duplicates are already blocked at save time.

Sharing — your public List

Most of your library is private. Mark individual links public to publish them to List, a clean public page of your hand-picked links:

/share <id>     — toggle a link onto (or off) your List

List lives at /list on your Worker — e.g. https://linkbrain.<you>.workers.dev/list — grouped by collection. A link shows 🌐 on its result card when it’s public. Everything else stays private; only links you explicitly /share are ever served.

Export

Get your whole library as a file, sent straight to your Telegram chat:

/export          — Markdown (default)
/export csv      — CSV (spreadsheet-friendly)
/export json     — JSON (full structured data)

The export covers every link (private ones too) with its url, title, summary, tags, note, category, collection, and status.