Documentation

Command-D remembers things for you. One keystroke on your Mac, one share on your phone — saved, enriched, and searchable. No account needed, ever.

Installing on Mac

Download the app (Apple Silicon), unzip, and drag Command-D.app to Applications. This is an early build that isn’t notarized by Apple yet, so the first launch takes one extra step:

  1. Double-click the app — macOS will refuse; dismiss the dialog.
  2. Open System Settings → Privacy & Security, scroll down, and click Open Anyway next to Command-D.
  3. The ⌘D icon appears in your menu bar. Use its menu to enable Start at login.

Terminal alternative for step 1–2: xattr -d com.apple.quarantine /Applications/Command-D.app

Saving things

Mac — copy anything (⌘C), then hit ⌘D. A “Stored ✓” toast appears under the menu bar icon. Links, text, and images on the clipboard all work; several images copied in Finder go up as one stack. The menu bar ⌘D icon shows your five most recent saves.

Android — install the app (the Install the app button on the homepage, or Chrome menu → Add to Home screen → Install). Then use the regular share sheet from any app — YouTube, LinkedIn, your browser — and pick Command-D. Step by step: Android setup.

iPhone & iPad — iOS has no install button and only lets App Store apps into the share sheet, so it takes two small steps: add your list to the Home Screen from Safari, and a Shortcut for Share → Command-D from any app. Set up iPhone walks you through both.

Windows — install the app the same way in Chrome or Edge (install icon in the address bar). Command-D then appears in the Windows Share menu, and the app window is your list. A native tray app with a global hotkey is planned; until then, paste into the list or use Share.

Browser — paste a link or note in the box at the top of your list.

Every saved link is enriched automatically in the background: title, description, preview image, favicon. YouTube, X and TikTok links get the real thing — the video title and thumbnail, the tweet’s text and photos, and the video behind it (a tweet that embeds a YouTube video is saved as something to watch). Saving the same link twice never creates a duplicate; it bumps the item back to the top of your list and, if you had marked it done, back into your inbox.

What can be stored: links, text notes (up to 100 KB), and images (any common format, up to 4 MB). Videos are saved as links — Command-D remembers where things are and what they’re about; it’s not a file locker.

Finding them back

Your list at cmd-d.com/app is newest-first with full-text search over titles, descriptions, content, and URLs — the enrichment means you can search for words you never typed. Filter by Links, Images, or Text — or ▶ Videos for everything you saved to watch later, whatever site it came from.

Done with something? Hover a card and hit ✓. It leaves your inbox but nothing is deleted: the ✓ Done view shows everything you finished, search still finds it, and ↩ puts it back. Saving is still one keystroke — sorting is optional and comes later, if ever. Items you open from the list are marked opened so you can see what you already looked at. The Mac menu bar does the same: hold ⌥ on a recent item to mark it done without opening it.

Tags are optional too: # on a card adds one, clicking a tag filters the list by it. Your AI can tag things for you over MCP.

One list on every device

Each device starts its own private list — no signup. To make them one list: on a device that has your list, open Devices & links (top right of the list page) → Show code & QR. Scan the QR code with the other device’s camera, or enter the 6-character code there, within 10 minutes. From then on Mac, phone, and browser share the same list. The Mac app’s Open my list pairs your browser automatically.

Sharing links

Found something a friend or colleague should see? The share button on a card makes a link to that item; with a tag filter on, Share #tag makes a link to everything with that tag, including what you tag later. Whoever opens the link sees the previews and can save items into their own list with one tap (no account; a list is made for them). Your other items, tags and notes stay private. Devices & links lists your live links; Stop sharing makes a link stop working immediately.

Connect your AI (MCP)

Command-D speaks MCP, so Claude, ChatGPT, and Gemini can search your list, and save to it, mid-conversation — “what was that video I saved last week?” just works.

Get your personal connector URL from your list → Pair a device → Connect your AI. It looks like:

https://cmd-d.com/api/mcp?token=cmdd_…

Treat that URL as a secret — anyone who has it can read and add to your list.

Tools your AI gets: search_items, get_recent_items, get_item, list_tags (read-only; filter by inbox / done, by tag, by site, or media=video for your watch list; lists page on so your AI can go through everything), view_images to look at your screenshots and photos themselves (“read my last screenshots” gets the whole set you saved together), save_item — so an agent doing research can ⌘D things for you — and update_item to archive, restore or tag things (“mark everything about React I opened last week as done”). Nothing your AI does can delete an item.

Point your AI at one thing: a card’s 🔗 copies a reference, a link like cmd-d.com/app?item=4f1c2a9b (a stack’s is ?stack=…). Paste it with your question (“what does this say? cmd-d.com/app?stack=77f2b77a”) and your AI looks it up with the tools above; opened in a browser, it shows that card in your list. The card’s ⧉ copies the thing itself instead: the link, the text, or the image, ready to paste.

API

Everything is API-first — your own scripts and frontends are welcome. Create an identity once, keep the token:

# one-time: get a token
curl -X POST https://cmd-d.com/api/devices

# save
curl -X POST https://cmd-d.com/api/items \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"content": "https://youtu.be/dQw4w9WgXcQ"}'

# search (add &status=all to include what you marked done)
curl "https://cmd-d.com/api/items?q=rick" \
  -H "Authorization: Bearer $TOKEN"

# watch list: videos not yet done (format=long for the couch, format=short for reels & TikToks)
curl "https://cmd-d.com/api/items?media=video&format=long" \
  -H "Authorization: Bearer $TOKEN"

# done with it (reversible: "archived": false)
curl -X PATCH https://cmd-d.com/api/items/$ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"archived": true, "add_tags": ["ai"]}'

# a note in your own words; #words become tags
curl -X PATCH https://cmd-d.com/api/items/$ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"note_and_tags": "watch before the RSC talk #react"}'

Full reference: OpenAPI spec.

Your data

What we store: the things you save, the metadata enrichment finds (page titles, descriptions, preview images), and timestamps. No account, no email, no tracking. Deleting an item removes it immediately. Your list is private to your devices and the AI connectors you explicitly add.