Sources
Every source Geneziz captures from - the browser extension in your logged-in session, official APIs, and file imports - and how each plane works.
Two capture planes
Geneziz collects saves through two planes, plus file imports:
- Browser extension - capture happens inside your own logged-in session as you browse. Geneziz never reads your browser's stored cookies, and nothing is sent to a cloud.
- Official APIs - sources with a public API connect with your own token or OAuth grant and sync on demand.
Browser extension sources
The Save to Geneziz extension captures:
- X.com bookmarks
- Instagram saved posts
- TikTok favorites
- Reddit saves
- cosmos.so saves
- Any page - save the current tab from the extension
X.com capture is bookmarks only. The extension runs in your logged-in session; each captured item lands in your vault as Markdown.
Official API sources
| Source | What syncs | Auth |
|---|---|---|
| GitHub | Your starred repositories | Personal access token |
| YouTube | Videos from playlists you created, plus your liked videos | Google OAuth |
| Bluesky | Your likes feed and your lists | App password |
| Hacker News | Public feeds (top, new, best, Ask, Show, jobs) and any story by URL | None (public API) |
| RSS | Any feed you add | - |
Connect accounts in Settings - Connections. Personal and work accounts can sit side by side per source; sync runs each active account and the viewer shows a combined view with per-account filtering.
Fetch from the CLI:
geneziz fetch --source github # all active GitHub accounts
geneziz fetch --source github --account gh-work # just one
geneziz sync # bookmarks + GitHub stars
Imports
Bring an existing library with you:
- Pocket - export your Pocket library as JSON, then
geneziz import-pocket --input path/to/pocket-export.json - Browser bookmarks - export the bookmarks HTML file from Chrome, Firefox, Edge, or Safari, then import it
Run geneziz process after an import to classify and file the items.
Where items go
Every captured or imported item is enriched and filed into your local knowledge base. See the vault for the file layout, and the overview for the full pipeline. Product details are on /landing.