/push docs

The manual for the terminal that remembers your agent sessions.

Browse the docs
Browser

Browser extension

Save any page with a note, straight to your Push Mac — no cloud account in between.

The Chrome extension is a capture path: click, type a note ("read this later"), Save to Push — an issue lands on your Mac with the page's URL and title attached, and shows up everywhere your workspace does: the Mac app, your iPhone, the CLI.

There's deliberately little to it: no sign-in, no separate cloud account, no AI in the extension. It talks to your Push Mac.

Same Mac: zero setup

If Chrome runs on the Mac that runs Push, you're done — the extension finds your local Push server automatically and shows a small "→ local · workspace name" indicator so you know exactly where captures land.

Different machine: pair once

Browsing on a laptop while Push runs on your desk Mac? Generate a one-time pairing link from the Mac's Settings → Workspace pairing section, paste it into the extension, Connect. The link is single-use and expires in minutes; the pairing that results is a device credential your Mac lists — and can revoke — under Settings → Workspace → Devices, like any other paired device. Traffic between the browser and your Mac goes through the relay.

No duplicates

Saving a page you've already saved doesn't create a second issue: the extension shows an "Already saved" banner and your new note lands as a comment on the existing issue's timeline.

Verified against Push 1.10.197 · Updated 2026-08-08