Browse and search your bookmarks
Swipe to delete or archive
Add bookmarks manually
Share to Marks from any app (share extension)
Tag browser — see all tags sorted by count, tap to filter
Native search tab with instant client-side filtering
AI enrichment via OpenRouter — auto-generates summaries and tags for each bookmark
Semantic search — rank bookmarks by relevance using AI
Smart Collections — AI groups your bookmarks into themed collections
Pagination — loads more as you scroll

Requirements

iOS 26+
A running linkding instance with API access
(Optional) An OpenRouter API key for AI features

AI Features

All AI features are optional and powered by OpenRouter using google/gemini-2.0-flash-lite-001 — one of the cheapest available models (~$0.075/M input tokens).

Feature	What it does
Auto-enrichment	Generates a one-sentence summary and 3-5 tags for each bookmark
Semantic search	Ranks your bookmarks by relevance to a natural language query
Smart Collections	Groups up to 150 bookmarks into 3-6 themed collections

Add your OpenRouter API key in Settings to enable these features.

Building

Requires xcodegen.

brew install xcodegen
xcodegen generate
open Marks.xcodeproj

Then build and run in Xcode. The project uses automatic signing — set your development team in project.yml under DEVELOPMENT_TEAM.

Architecture

SwiftUI with @Observable and @MainActor throughout (Swift 6 strict concurrency)
LinkdingAPI — thin wrapper around the linkding REST API
ClaudeService — OpenRouter client for AI enrichment, semantic search, and collections
BookmarksViewModel — central state: bookmarks list, pagination, search, enrichment progress
App Groups — share extension and main app share credentials via group.com.magicive.marks
UserDefaults — AI summaries and tags cached locally by bookmark ID

Project structure

Marks/
  Models/         Bookmark, ServerConfig, SmartCollection
  Services/       LinkdingAPI, ClaudeService
  Views/          BookmarksView, TagsView, SearchView, SettingsView, …
  Assets.xcassets App icon and assets
ShareExtension/   iOS share extension (zero-tap bookmark saving)
project.yml       xcodegen project spec