Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,15 +15,15 @@ The first tagged release, and the first published image: `docker compose up -d`
- **Pluck anything in one tap:** a link, a Note, a Todo or a Thing, from the web (one link or a paste of many), the browser extension, the iPhone and iPad share sheet, Siri and Shortcuts, email-in, or a chat with your AI. A Re-pluck brings the Item back to the Inbox and never makes a second one.
- **The page is kept, not just the link.** Each link opens as what it is: an article in the Reader, a video in a player, a post, a repo, a product, a PDF on its own pages.
- **Kinds and Statuses:** Read, Watch, PDF, Image, Note, Todo, Thing; Inbox, Later, Archived, Done. Tags, Highlights, and search across your library, in Japanese, Chinese and Korean too.
- **Lists:** ordered, with a note and a tick per Item. Private, Public at `/@handle/slug`, or shared with particular people by email, See only.
- **Lists:** ordered, with a note and a tick per Item. Private, Public at `/@handle/slug`, or shared with particular people by email, See only. A public List has an Atom feed at `/@handle/slug/feed.xml`.
- **Expiry:** Items you never touch move to the Archive after the number of days you pick. Nothing is deleted. A deleted Item waits 30 days in the Bin.
- **The Digest:** a weekly email of what will expire, what is due and what is oldest, on Monday unless you pick another day.
- **The connector:** your AI reads and organises your library over MCP at `/mcp`, with OAuth, or through `npx @getpluck/mcp` for tools that only speak stdio. There is no AI inside the app. Your AI cannot delete anything unless you grant it, cannot make a List public, and what it adds is marked "by AI".
- **Import and export:** import from Pocket, Omnivore, Raindrop and browser bookmarks; export everything as JSON and Markdown; delete the account yourself.
- **Apps:** the web app, Pluck for Chrome (and a Firefox build for your own server), and the iPhone and iPad app, which works offline from the last copy and keeps the newest Items for reading with no connection.
- **The connector:** your AI reads and organises your library over MCP at `/mcp`, with OAuth, or through `npx @getpluck/mcp` for tools that only speak stdio. There is no AI inside the app. Your AI cannot delete anything unless you grant it, cannot make a List public, and what it adds is marked "by AI". It finds an Item by what you highlighted in it, lists your highlights across the library, and every tool declares the shape of its result.
- **Import and export:** import from Pocket, Omnivore, Raindrop, Instapaper, Readwise Reader, Wallabag, Linkwarden, Karakeep and browser bookmarks; export everything as JSON and Markdown, with a `bookmarks.html` that a browser or another app can import; delete the account yourself.
- **Apps:** the web app, Pluck for Chrome (from 0.2.4 its Options can point it at a server you run, once you allow it; there is a Firefox build too), Android's Share sheet through the installed web app, and the iPhone and iPad app, which works offline from the last copy and keeps the newest Items for reading with no connection.
- **Sign-in by email only:** a link on the web, a 6-digit code on the iPhone. API keys for scripts and the stdio bridge.
- **Ten languages:** English, Spanish, Portuguese (Brazil), French, German, Japanese, Italian, Dutch, Korean and Chinese (Simplified).
- **Run your own:** one Docker image for the web app and the worker, with MongoDB and an S3-compatible blob store, under Apache-2.0. Analytics are off unless you build with your own PostHog key.
- **Run your own:** one Docker image for the web app and the worker, with MongoDB and an S3-compatible blob store, under Apache-2.0. Analytics are off unless you build with your own PostHog key. What Pluck defends against, and where each rule lives, is in `docs/threat-model.md`.

### Since the repository went public (2026-10-27)

Expand Down
2 changes: 1 addition & 1 deletion apps/web/app/(site)/connect/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ const TOOLS = [
{ key: "self", code: "npx @getpluck/mcp --server https://pluck.your.host --key pk_live_…" },
] as const;

const TOOL_LIST = ["search_items", "list_items", "get_item", "save_item", "batch_update", "list_tags", "create_tag", "list_lists", "get_list", "create_list", "update_list", "get_digest"] as const;
const TOOL_LIST = ["search_items", "list_items", "get_item", "list_highlights", "save_item", "batch_update", "list_tags", "create_tag", "list_lists", "get_list", "create_list", "update_list", "get_digest"] as const;
const ASKS = ["tidy", "reading", "ideas", "review"] as const;
const NEVER = ["delete", "makeTag", "renameTag", "purpose", "public"] as const;

Expand Down
2 changes: 1 addition & 1 deletion docs/deploy.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ Once, on npmjs.com, as an owner of the `@getpluck` scope:

Each release:

1. Raise `version` in `packages/mcp-stdio/package.json` in a pull request and merge it. 0.1.0 went up by hand, so the first release from the workflow is the next version.
1. Raise `version` in `packages/mcp-stdio/package.json`, and the two `version` fields in `server.json` to match (a test fails if they differ), in a pull request and merge it. 0.1.0 went up by hand, so the first release from the workflow is the next version.
2. Tag that commit on `main` and push the tag: `git tag mcp-v<version> && git push origin mcp-v<version>`. The workflow stops if the tag and the version differ.
3. Watch the run in Actions, then `npm view @getpluck/mcp version`, and look for the provenance on the package's npm page.

Expand Down
2 changes: 1 addition & 1 deletion packages/db/src/collections.ts
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ export type ItemDoc = {
tagNames?: string[];
listNames?: string[];
inList?: boolean; // in at least one list: exempt from expiry
searchText?: string; // excerpt, site, host, author
searchText?: string; // excerpt, site, host, author; then, after a mark, the Item's highlights (search.ts)
searchBody?: string; // the kept text or the note body, capped
deletedAt: Date | null; // in the bin; purged 30 days later
purging?: true; // claimed by a purge (purgeDocs in items.ts): its files and rows are going, and it cannot come back
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/de.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "Dieselben Tools und Prompts, verbunden mit deinem eigenen Server."
}
},
"toolsTitle": "Zwölf Tools. Klare Namen.",
"toolsTitle": "Dreizehn Tools. Klare Namen.",
"toolsBody": "Ergebnisse kommen als Karten zurück, Titel zuerst, also ist eine Frage wie „Was habe ich diese Woche gepflückt?“ ein Aufruf und ein Bildschirm.",
"toolList": {
"search_items": "Textsuche über Titel, Notiz, Tags, Listennamen und Text.",
"list_items": "Eingang, Später, Archiv oder Erledigt durchsehen, neueste oder unberührte zuerst.",
"get_item": "Ein Eintrag vollständig, samt gespeichertem Seitentext.",
"list_highlights": "Was du markiert hast, mit deinen Notizen dazu.",
"save_item": "Einen Link, viele Links, eine Notiz, eine Aufgabe oder ein Ding pflücken. Markiert als von KI gepflückt.",
"batch_update": "Status, Art, Tags und Fälligkeitsdaten für einen oder viele Einträge.",
"list_tags": "Deine Tags, mit Anzahl.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/en.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "The same tools and prompts, bridged to your own server."
}
},
"toolsTitle": "Twelve tools. Plain names.",
"toolsTitle": "Thirteen tools. Plain names.",
"toolsBody": "Results come back as cards with titles first, so a question like “what did I pluck this week” is one call and one screen.",
"toolList": {
"search_items": "Text search over title, note, tags, list names and body.",
"list_items": "Browse Inbox, Later, Archive or Done, newest or untouched first.",
"get_item": "One item in full, including the stored page text.",
"list_highlights": "What you highlighted, with your notes on it.",
"save_item": "Pluck a link, many links, a note, a todo or a thing. Marked as plucked by AI.",
"batch_update": "Status, kind, tags and due dates on one or many items.",
"list_tags": "Your tags, with counts.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/es.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "Las mismas herramientas y prompts, conectados a tu propio servidor."
}
},
"toolsTitle": "Doce herramientas. Nombres claros.",
"toolsTitle": "Trece herramientas. Nombres claros.",
"toolsBody": "Los resultados llegan como tarjetas, con el título primero, así que una pregunta como “qué recogí esta semana” es una llamada y una pantalla.",
"toolList": {
"search_items": "Búsqueda de texto en título, nota, etiquetas, nombres de listas y texto.",
"list_items": "Explora la Bandeja de entrada, Más tarde, el Archivo o Hecho, con lo más reciente o lo que lleva más tiempo sin tocar primero.",
"get_item": "Un elemento completo, incluido el texto conservado de la página.",
"list_highlights": "Lo que resaltaste, con tus notas.",
"save_item": "Recoge un enlace, varios enlaces, una nota, una tarea o una cosa. Marcado como recogido por IA.",
"batch_update": "Estado, tipo, etiquetas y fechas de vencimiento de uno o varios elementos.",
"list_tags": "Tus etiquetas, con recuentos.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/fr.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "Les mêmes outils et les mêmes prompts, reliés à votre propre serveur."
}
},
"toolsTitle": "Douze outils. Des noms simples.",
"toolsTitle": "Treize outils. Des noms simples.",
"toolsBody": "Les résultats reviennent sous forme de cartes, titres en premier : une question comme « qu’est-ce que j’ai cueilli cette semaine » tient en un appel et un écran.",
"toolList": {
"search_items": "Recherche texte dans le titre, la note, les tags, les noms de listes et le texte.",
"list_items": "Parcourir la boîte de réception, Plus tard, les Archives ou Terminé, les plus récents ou les délaissés d’abord.",
"get_item": "Un élément en entier, avec le texte de la page gardée.",
"list_highlights": "Ce que vous avez surligné, avec vos notes.",
"save_item": "Cueillir un lien, plusieurs liens, une note, une tâche ou un objet. Marqué comme cueilli par l’IA.",
"batch_update": "Statut, type, tags et échéances sur un ou plusieurs éléments.",
"list_tags": "Vos tags, avec leur nombre d’éléments.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/it.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "Gli stessi strumenti e prompt, collegati al tuo server."
}
},
"toolsTitle": "Dodici strumenti. Nomi semplici.",
"toolsTitle": "Tredici strumenti. Nomi semplici.",
"toolsBody": "I risultati tornano come schede con i titoli in primo piano, così una domanda come “cosa ho preso questa settimana” è una chiamata e una schermata.",
"toolList": {
"search_items": "Ricerca testuale su titolo, nota, tag, nomi delle liste e testo.",
"list_items": "Sfoglia Inbox, Più tardi, Archivio o Fatto, prima i più recenti o prima i non toccati.",
"get_item": "Un elemento completo, compreso il testo della pagina conservata.",
"list_highlights": "Quello che hai evidenziato, con le tue note.",
"save_item": "Prende un link, più link, una nota, un Da fare o un Oggetto. Segnato come preso dall'IA.",
"batch_update": "Stato, tipo, tag e scadenze su uno o più elementi.",
"list_tags": "I tuoi tag, con i conteggi.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/ja.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "同じツールとプロンプトを、自分のサーバーにつなぎます。"
}
},
"toolsTitle": "12のツール。わかりやすい名前。",
"toolsTitle": "13のツール。わかりやすい名前。",
"toolsBody": "結果はタイトルを先頭にしたカードで返ります。「今週何をPluckした?」のような質問なら、呼び出し1回、画面ひとつで済みます。",
"toolList": {
"search_items": "タイトル、メモ、タグ、リスト名、本文のテキスト検索。",
"list_items": "インボックス、「あとで」、アーカイブ、完了を、新しい順か手つかずの順で表示。",
"get_item": "アイテムひとつのすべて。残したページの本文も含みます。",
"list_highlights": "ハイライトした箇所と、そこに付けたメモ。",
"save_item": "リンク(複数も可)、メモ、ToDo、モノをPluck。AIがPluckしたという印が付きます。",
"batch_update": "1件または複数のアイテムの、ステータス、種類、タグ、期限。",
"list_tags": "タグと、それぞれの件数。",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/ko.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "같은 도구와 프롬프트를, 내 서버에 연결해서."
}
},
"toolsTitle": "도구 12개. 쉬운 이름.",
"toolsTitle": "도구 13개. 쉬운 이름.",
"toolsBody": "결과는 제목이 먼저 오는 카드로 돌아와요. 그래서 “이번 주에 뭘 담았지” 같은 질문은 호출 한 번, 화면 하나면 끝나요.",
"toolList": {
"search_items": "제목, 메모, 태그, 리스트 이름, 본문 텍스트 검색.",
"list_items": "수신함, 나중에, 보관함, 완료를 최신순이나 손대지 않은 순으로 보기.",
"get_item": "항목 하나 전체, 담아 둔 페이지 본문까지.",
"list_highlights": "하이라이트한 부분과 거기에 남긴 메모.",
"save_item": "링크, 여러 링크, 메모, 할 일, 물건 담기. AI가 담았다고 표시돼요.",
"batch_update": "항목 하나 또는 여러 개의 상태, 종류, 태그, 마감일.",
"list_tags": "내 태그와 개수.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/nl.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "Dezelfde tools en prompts, doorgeschakeld naar je eigen server."
}
},
"toolsTitle": "Twaalf tools. Heldere namen.",
"toolsTitle": "Dertien tools. Heldere namen.",
"toolsBody": "Resultaten komen terug als kaarten met de titel voorop, dus een vraag als “wat heb ik deze week geplukt” is één aanroep en één scherm.",
"toolList": {
"search_items": "Zoeken op tekst in titel, notitie, tags, lijstnamen en paginatekst.",
"list_items": "Door Inbox, Later, Archief of Klaar bladeren, nieuwste of onaangeroerd eerst.",
"get_item": "Eén item volledig, met de bewaarde paginatekst.",
"list_highlights": "Wat je hebt gemarkeerd, met je notities erbij.",
"save_item": "Pluk een link, veel links, een notitie, een taak of een ding. Gemarkeerd als geplukt door AI.",
"batch_update": "Status, soort, tags en deadlines van één of veel items.",
"list_tags": "Je tags, met aantallen.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/pt-BR.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "As mesmas ferramentas e os mesmos prompts, ligados ao seu próprio servidor."
}
},
"toolsTitle": "Doze ferramentas. Nomes simples.",
"toolsTitle": "Treze ferramentas. Nomes simples.",
"toolsBody": "Os resultados voltam como cartões, com os títulos primeiro, então uma pergunta como “o que eu colhi esta semana” é uma chamada e uma tela.",
"toolList": {
"search_items": "Busca de texto em título, nota, tags, nomes de listas e conteúdo.",
"list_items": "Navegar pela Entrada, por Depois, pelo Arquivo ou pelos Concluídos, mais novos ou sem mexer primeiro.",
"get_item": "Um item completo, incluindo o texto guardado da página.",
"list_highlights": "O que você destacou, com suas notas.",
"save_item": "Colher um link, vários links, uma nota, uma tarefa ou uma coisa. Marcado como colhido pela IA.",
"batch_update": "Status, tipo, tags e prazos em um ou vários itens.",
"list_tags": "Suas tags, com contagens.",
Expand Down
3 changes: 2 additions & 1 deletion packages/i18n/messages/site/zh-Hans.json
Original file line number Diff line number Diff line change
Expand Up @@ -338,12 +338,13 @@
"note": "同样的工具和提示词,桥接到你自己的服务器。"
}
},
"toolsTitle": "十二个工具。名字一看就懂。",
"toolsTitle": "十三个工具。名字一看就懂。",
"toolsBody": "结果以卡片形式返回,标题在前,所以像“我这周摘了些什么”这样的问题,一次调用、一屏就能看完。",
"toolList": {
"search_items": "在标题、笔记、标签、清单名称和正文中进行文本搜索。",
"list_items": "浏览收件箱、稍后、归档或已完成,按最新或最久没动排序。",
"get_item": "完整的单个条目,包括留存的网页正文。",
"list_highlights": "你标亮的内容,以及你写下的备注。",
"save_item": "摘下一个链接、多个链接、一条笔记、一条待办或一件物品。标记为由 AI 摘下。",
"batch_update": "为一个或多个条目设置状态、类别、标签和截止日期。",
"list_tags": "你的标签,附带数量。",
Expand Down
Loading