Skip to content
Web Clipper

Save a web page into your vault as Markdown.

A browser extension that clips the page you are reading — or just the part you selected — into the Altretta app running on your own machine. The clip arrives as a proposal in your review inbox, not as a note in your vault.

Chromium browsersTalks only to your own machineNothing is signed until you approve it
What it does

One click, one Markdown file, with its source attached.

The extension reads the page in the tab you are on, strips the navigation and the advertising around the article, and converts what is left to Markdown.

Clip the whole page

The article is extracted from the page the way a reader view does it, so you keep the text and lose the furniture. When a page resists extraction the extension falls back to the full body and tells you it did, rather than silently saving something thinner than you expected.

Clip just a selection

Select text first and the second button lights up. Only the selected HTML is converted, so a single quoted paragraph does not arrive wrapped in the whole page.

Plain Markdown, nothing proprietary

The result is a Markdown file like every other note in your vault. There is no clipper format and nothing to export later.

The source travels with it

Each clip carries frontmatter naming the page it came from, the moment it was clipped, its pending status, and a web-clip tag — plus the byline, site name and publication date when the page states them.

The part that matters

A clip is a proposal, not a note.

The extension stages the clip in your vault's inbox folder with a pending status. It is not indexed, not added to your semantic graph, and not signed. Nothing about it becomes part of your knowledge base until you open the app and approve it.

Why a web clipper is the case for an inbox

A clipper is the fastest way to fill a knowledge base with material you have not read. Letting it write straight into your notes would mean your own vault — the thing your AI answers from — quietly filling with pages you merely intended to read. So a clip goes where an AI proposal goes: into the review inbox, behind a human decision.

  • The extension never signs anything and never writes to the graph. Its job ends at staged.
  • Approving is the accountable act, and approval is what gets recorded as a signed action.
  • Rejecting archives the proposal instead of deleting it.
  • Clip the same unchanged page twice and it is recognised rather than duplicated.
How the review inbox works
Pairing

You generate a token in the app and paste it into the extension.

There is no account, no sign-in and no cloud step. The extension talks to the Altretta app on your own machine, and the token is what proves it may.

01

Open the app's connection settings

Settings, then AI and connections, then the External assistants section. It has a Web Clipper block of its own.

02

Copy the endpoint and the token

The endpoint address is shown with a copy button. Press Get pairing token and the app mints a token labelled for the clipper, which you can reveal and copy.

03

Paste both into the extension

Open the extension's options page — the popup links to it while it is unpaired — and paste the endpoint and the token there.

04

Test the connection, then save

Test connection performs a real handshake with the app and reports back which server answered. If the app is not running, it says so instead of failing later on your first clip.

The token is kept in your browser's own extension storage on that machine. It is not synced anywhere, and revoking it in the app is enough to end the pairing.

Browser support

Chromium browsers, today.

The extension is built to the Manifest V3 standard against the Chromium extension APIs, and the install procedure is written for the Chrome and Edge extension pages.

Chrome and Edge

Both read the same manifest and both expose the developer-mode install used below. Other Chromium browsers that offer the same page are likely to work, but they are not the ones this was tested against, so they are not claimed.

Firefox and Safari

Not supported. The extension carries no Firefox add-on identity and no Safari packaging, so there is nothing to install there yet — this is a gap to close, not a decision.

Installing

Download it, then load it unpacked.

The clipper is published with every release of the app, as a zip on the same download host the installers come from. There is still no store listing, so getting it installed is two steps rather than one button.

Get the extension

One archive, built and published by the same release that built the app. The version in the filename is the app version it shipped with, and it is stamped into the extension itself — so the number your browser shows on its extensions page is the number to quote if you report a problem.

Download the extension

Version 0.9.4 · Altretta_0.9.4_web-clipper.zip

Unzip it somewhere you are willing to leave it. The browser reads the extension from that folder every time it starts, so moving or deleting the folder uninstalls it.

Loading it into the browser

A zip is installed by loading it unpacked, which is a browser feature rather than a workaround:

  1. 01Download the archive above and unzip it into a folder you intend to keep.
  2. 02Open your browser's extensions page.
  3. 03Turn on Developer mode.
  4. 04Choose Load unpacked and select the folder you unzipped.
  5. 05Pair it with the app using the token above.

An unpacked extension stays installed until you remove it, and it keeps its pairing token across browser restarts.

When a new version ships

An unpacked extension does not update itself. Your browser will keep running the copy in that folder indefinitely, and nothing will tell you a newer one exists — which is exactly why this paragraph is here rather than assumed. When the app updates, come back to this page, download the new archive, unzip it over the same folder, and press Reload on the extension in your browser's extensions page. That is the cost of not having a store listing, and it is paid once per release.

Still no store listing

The clipper has not been published to the Chrome Web Store or to the Edge add-ons catalogue. A listing is what would make installation one click and updates automatic; a zip is what exists today, and the rest of this page is written for the zip.

What it touches

It reaches your machine and nothing else.

One destination

The extension is permitted to reach loopback addresses only — the app on the computer it is installed on. It has no analytics, loads nothing from a CDN, and makes no other network call.

The tab you are on

It reads the active tab when you press a button, and only then. It does not run on pages in the background and does not watch what you browse.

Your vault, on your disk

The clip is written into your own vault folder as a file you can open in any editor. Nothing is uploaded, and nothing about it leaves the machine.