Help

hereyougo keeps what I've made, read and saved: posts written here, and links saved from the web, Pinboard and X.

Getting around

Navigation

• The top row is for everyone: Search (press / to jump to it), then Posts (everything written here, newest first or A–Z), Topics (every tag with three or more entries, each with its own page), Archive (everything, by date, with filters) and Discover. The site's name goes to the front page: the latest posts and notes, the links saved lately, the main topics and what was saved on this day in earlier years.
• A topic's page (click any #tag) has its notes and posts as cards, its links, and the topics that most often go with it.
• Every entry has its own page: open a row and follow Permalink. Links without a page of their own get one at /e/…; logged in, edit the entry there and write about it, and it shows above the link.
• A post's page lists its sections under On this page when it has three or more, and ends with the posts that link to it, related entries (sharing tags, and close in meaning once indexed) and its topics. Links out to the web are marked ↗; links to other notes here have a dotted underline.
• The second row is yours, when logged in, grouped by what it's for: Add · Review, Tags & folders, Trash · Import, Export · Housekeeping, Changelog, Help · Log out.
• The page you're on is underlined in the header. Pages start with their name; tabs inside a page (All / Notes / Posts, Newest / A–Z, Tags / Folders) switch views of that page.

Logged in

You're not logged in. Log in to see private entries and use the tools.

Logging in shows your private posts and links, the second row of the header, and the controls on every entry. Logins expire after a while: if a page suddenly asks you to log in, or Read later shows a login page, log in again and retry.

The controls on every entry

Logged in, every link and post has the same controls wherever it can be changed: the Archive, Discover, search, Review and a post's own page. In a list, open a row to see them. The front page, Posts and topic pages are for finding things, so their entries just open.

• Edit opens the entry's form right there. Ctrl/⌘+Enter saves, Esc cancels.
• Public / Private (and Unlisted for posts) are radio buttons: pick one and it's saved. Read later / Done reading switches on and off; the button says what pressing it does.
• Check link (links) checks the address now.
• Not interesting moves it to the Trash, with an Undo right there. Delete deletes it for good after asking once.

Private entries have an amber stripe and a Private label, so they stand out.

Saving

Add a link or a post

Add saves a link, or with the URL left empty, a post.

• Posts: write in Markdown, paste a screenshot, or drop files on the file area (several at once; each shows a preview and its size). Images appear where you paste them. An HTML page or PDF becomes the post itself; a zip is unzipped and its index page becomes the post. Each post gets its own link, /p/your-title.
• Images anywhere: drop or paste images (or drag one from another page) into any description, post body or note, on Add or when editing any entry, link or post. Each is uploaded at once and appears where the cursor is, as Markdown. It shows to visitors only once you save, and only if the entry is public; a private entry's images stay private, and they go when the entry is deleted for good.
• Tags and folders suggest names you already use: green ones exist, red ones are new and saving creates them.
• Links lose their tracking parameters when saved (utm_…, click ids, and the whole ?s=…&t=… on X links). A link you've saved before isn't saved twice: the form shows what you saved and saving updates it.

Bookmarklets

Two buttons for your browser's bookmarks bar save whatever page you're on. They work like Pinboard's, so you can replace those.

1. Show your bookmarks bar: Cmd+Shift+B on a Mac, Ctrl+Shift+B on Windows and Linux.
2. Drag each button onto the bar: Read later Full page

If you can't drag (Safari on iPhone or iPad, for example), bookmark any page, edit that bookmark, and replace its address with one of these:

• Read later saves the page in one click without leaving it: a small window opens, saves and closes itself. The link is private and marked to read (Archive, Show: To read). Saved before? It's marked to read again, and comes back out of the Trash.
• Full page opens Add with the page's address and title filled in; text you selected first becomes the description. Saving takes you back to the page.
• If Read later shows a sign-in page, your login expired: log in again and click it once more. If nothing happens, your browser blocked the small window: allow pop-ups for this site, or use Full page. If a saved page isn't in the list, it's private, so it only shows when you're logged in.

Share by email

Email something to your sharing address and it's saved here. From a phone, use Share, then Mail.

Only the site's owner can share by email.

• A link (as the subject, or the first line of the message) is saved as a link: the subject is its title, the rest of the message its description.
• Anything else becomes a post: the subject is the title, the message the body. Attached images go in the post; an attached PDF, HTML page or zip becomes the post itself.
• Everything is private until you publish it. Put #public in the subject to publish straight away; other #words become tags.
• A link you've already saved is updated, not saved twice: new text is added to the description, new #words to its tags, and #public publishes it. Nothing is removed.
• You get a reply with the link, or with the reason nothing could be saved.

Finding things

Archive

• Archive lists everything: your posts, and every link from Pinboard, X, the bookmarklets and email.
• Search, then narrow by kind (posts or links), source, year, what an entry has (media, links, tags, to read, dead links, PDFs, shopping) and sort order. "Browse by tag, site, author, folder or language" lists the most common ones.
• On Search, the filters under the search box narrow the results by visibility (public, private, unlisted), kind, type (book, video, paper, code…), source, year, tag and what an entry has; each choice shows how many results it leaves, and the active filters show as chips you can remove one at a time. Filters work without any words too, and with search By meaning. Visitors get the same filters, minus visibility.
• The bars on the left show how many entries you saved each year; click one to see that year.
• Each row shows a title and the start of the description. Click it to see the rest: site, date, tags, images and, logged in, the controls.

Search

The search box at the top looks through posts and links together. Logged in, results come as a table with a visibility dropdown and the usual controls on each row.

Discover

Discover pulls corners out of the archive, each on its own page: PDFs (every saved link that opens a PDF, including PDFs linked from X posts), Books (anything tagged as a book, and links to Goodreads, publishers, bookshops, libraries and Amazon book pages) and Shopping (links to Amazon and other shops, and anything tagged #shopping or #purchase). Each has search, sort and its most common sites, and the same rows and controls as the Archive.

Who can see what

• Public: anyone. Public posts and links show on the front page, in Posts, on topic pages and in the Archive.
• Unlisted (posts only): anyone with the link, but it isn't listed anywhere.
• Private: only you, logged in. That includes a private post's files.
• X bookmarks are always imported as private. Pinboard bookmarks keep the setting they had on Pinboard.
• Change it with the Public / Private radios on any entry or in the search table (posts also have Unlisted), or in its Edit form.
• Signed in, a search with several results has a bulk bar: tick rows (or the header box for every row shown, or All N matching for the whole search, filters included), then Set visibility, Check links, Not interesting or Delete for good. Up to 25 links are checked at once; the rest go first in the checker's queue.

Looking after your links

Review

Review shows one saved link at a time, links you haven't looked at first, in random order, so you can tidy up fast without the mouse. Every action has a key, shown on its button.

• Next keeps the link and moves on; it comes back in a year.
• Back steps back through what you've seen this session. After a Trash, Back also takes the link out of the Trash.
• Edit opens the link's form in place; saving or cancelling returns you to the same link.

Tags and folders

Tags & folders lists them most used first, loading more as you scroll. Tags are spelled one way: lowercase, words joined by hyphens. A tag that's another spelling of one you have (a plural, a different separator, a synonym like go for golang or js for javascript) becomes that tag, whether you type it, import it or accept it from AI suggestions. Rename one to an existing name to merge them; tick one to show it in the sidebar for everyone (when it has public entries).

Dead links

Links are checked in the background every few months. One that fails twice, a few days apart, gets a Dead link label and, when the Wayback Machine has one, an Archived copy link to the snapshot closest to the day it was saved. Sites that refuse automated visits are never marked dead. Filter the Archive by Dead links or Has archived copy; Housekeeping shows how the checks are going.

Trash

Entries you mark Not interesting go to the Trash. Restore them, delete them one at a time, or Empty Trash to delete everything in it. A post in the Trash keeps its files (hidden from visitors), so restoring it brings it back whole. Its files go only when it's deleted for good, and then you can tick Keep next to any file: a kept file stays at its link, and stays private if the post was.

Ask, notes and suggestions

• Ask answers questions from your archive: “what have I saved about sqlite performance?”, “PDFs about rust from 2024”, “summarise my notes on writing”. It shows how it read the question (search words and filters, with a link to the same filter in the Archive), streams the answer with numbered links to the entries it used, and lists those entries with their usual controls. From an answer you can tag or file all of them, or save the answer as a private note. Earlier conversations are on the left.
• Every opened entry has a notes panel. Write a note, or select text in the entry and press Highlight to keep the passage with a note. Notes are private unless you tick Public when saving one, or press Make public on it later: a public note shows under Notes on the entry's page when the entry itself is public, and visitors' search finds the entry by it. Public notes don't go in the Atom feed. Your search and Ask use every note, private or public.
• Suggest tags asks for tags (mostly ones you already use), a folder and, for links, a short summary of the page. Nothing changes until you press ✓; ✕ dismisses a suggestion for good. Links saved in the last 30 days get suggestions on their own; the waiting ones are on Housekeeping › AI.
• Related lists entries close in meaning; post pages show related public entries to everyone. Ask about this asks about one entry (and reads its page).
• Search has a By meaning option that finds entries about the same thing even when the words differ. Housekeeping › Likely duplicates shows near-identical entries to keep one of.

Import and export

Import

• On Import, drop an X bookmarks JSON file (format below), a Pinboard or browser bookmarks HTML file, a Goodreads library export (Goodreads › My Books › Import and export › Export library, a CSV), or a backup from Export. You can drop several at once. Folders in a bookmarks file come in as folders. Goodreads books come in private, as books (Discover › Books): shelves become tags, to-read ones are marked To read, your rating and review go in the description, and Private Notes become a private note. Importing a newer export adds only books you didn't have, also skipping books saved here another way (a Goodreads or Amazon link, or another entry with the same ISBN); it doesn't update shelves or ratings on ones already here.
• Importing only adds links you don't have yet, so importing the same file again changes nothing.
• Import from X connects your X account and, once a day, saves your X bookmarks here as private links (X bookmark folders become folders), then removes them from X. X posts saved here without their text are filled in from X.
• Import from YouTube connects your Google account (read-only) and, once a day, saves the videos you've liked (in Liked on YouTube) and the videos in your playlists (a folder each) as private links, with their channel and thumbnail.
• Import from GitHub saves your starred repositories, starred gists and your own public gists (in My gists) once a day, all private: make any public yourself. Star Lists become folders; stars stay on GitHub.
• Both pages show each run and have a Sync now button.

X bookmarks JSON format

This is the format Import reads for X (Twitter) bookmarks. It's written so you can hand it to an LLM agent and ask it to turn bookmarks from somewhere else (a screenshot, a page, another export) into a file to import. Copy it below, or point the agent at /help/x-import.txt.

Export

• Export (logged in) downloads a standard bookmarks file that browsers and Pinboard can import, optionally styled for reading, or a full JSON backup. A backup brings back links, tags, folders and review progress; posts and their files aren't restored.
• To export part of the archive, filter it first and click Export these next to the filters.

Keyboard shortcuts

For logged-in use. Keys don't fire while you're typing in a field, except the ones with Ctrl/⌘ or Esc. Edit screens show their keys under the form.