Documentation Index
Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
- [Improved] Back up the Windows User PATH environment variable before modifying the registry, so it can be restored if anything goes wrong
- [Bug Fix] Fixed an issue on Windows where the one-click Linkly CLI setup could clear the user’s User PATH environment variable (only v0.3.4 was affected)
- [New] Added Integrations settings page — configure Linkly AI for Claude Code, Cursor, Codex, Cherry Studio and other MCP clients with one click
- [New] Added one-click Linkly CLI installer — automatically downloads the binary and configures PATH, no terminal commands needed
- [New] Added one-click Linkly Skills download — quickly integrate Linkly search into clients that support Agent Skills
- [New] Added NEW badges to sidebar navigation to help discover new features
- [New] Rewrote the first-run MCP integration onboarding step and completed UI internationalization
- [Improved] Unified icon style across Integrations and MCP-related settings
- [Bug Fix] Fixed a resource cleanup timing issue when quitting the app on macOS
- [Bug Fix] Fixed windows being unexpectedly repositioned when navigating between pages inside the same window
- [Bug Fix] Fixed an issue where external links and dialogs could not open inside the Settings window
- [Bug Fix] Fixed Codex icon display and minor sidebar layout issues
- [New] Support adding directories from NAS and external drives to your knowledge base (Windows and macOS only for now)
- [New] Support upgrading to Linkly AI Pro — lock in early bird pricing and get early access to more cloud services
- [Bug Fix] Fixed hidden windows triggering UI freeze detection
- [New] Filename quick indexing: after adding a directory, indexing completes in seconds — search by filename immediately without waiting for full-text indexing
- [New] Indexing performance mode: choose between Auto, Performance, and Balanced modes
- [New] Power saving mode: when enabled, pauses high-power tasks while running on battery
- [New] Independent toggles for Semantic Search and OCR
- [New] Support selecting multiple folders at once when adding directories
- [New] Beta program: opt in via Settings > About to get early access to new features
- [Improved] Enhanced index status page with progress and status display for all four index types
- [Improved] Smart indexing order: prioritizes lightweight formats like plain text and Markdown
- [Improved] Enlarged default settings window size for easier access to more settings
- [Bug Fix] Fixed folder removal not checking library references, causing accidental deletion
- [Bug Fix] Fixed occasional UI freeze during file indexing
- [Bug Fix] Fixed unstable sorting in index statistics chart
- [Improved] Image OCR optimization: reduced OCR resource usage, skip images with little text, improved handling of oversized images
- [Bug Fix] Fixed app freezing on Windows when indexing large collections of high-resolution images
- [Bug Fix] Fixed inability to record Alt+Space shortcut on Windows
- [Bug Fix] Fixed unfriendly error messages when a shortcut is already in use by another application on Windows
📚 Libraries are here! Organize your documents into libraries for more precise search within specific domains.🚀 New Features:
This upgrade will update existing index structures. Search results may be
inaccurate during the update — please wait for it to complete before
continuing use.
- [Desktop] Library Management — Create, edit, and delete libraries in Settings; organize folders into named libraries for structured management. View guide
- [Desktop] Library-Scoped Search — Type
@in the launcher to enter library-scoped search, pinpointing documents within a specific library; press Backspace to exit the scope - [Desktop] Document Type Filter — A filter panel automatically appears when search results contain multiple types; use
Cmd/Ctrl+↑/↓to quickly switch - [Desktop] Search Result Highlighting & Path Optimization — Keyword highlighting in titles and paths, smart path shortening, and opening files now reveals them in the file manager
- [MCP] New
list_librariestool for listing all knowledge libraries, usable with search and other tools - [MCP] New
exploreoverview tool — AI Agents can quickly understand the topic distribution, directory structure, and top keywords of a document collection or specific library - [MCP]
searchtool now supportslibraryandpath_globfilter parameters - [CLI] New
list-librariesandexplorecommands - [CLI]
searchsupports--libraryand--path-globflags - [CLI] New
linkly doctordiagnostic command to help AI Agents self-diagnose issues - [Skills] Added library support and troubleshooting guide, enabling Agents to search libraries and resolve common issues independently
- [Skills] Added usage instructions for
list-librariesandexplore - [Web] Dashboard now supports username settings for the cloud library namespace
- [Desktop] Search tool now returns up to 100 results, increased from 20
- [Desktop] Added search result caching — repeated searches for the same keywords return instantly for a smoother experience
- [Desktop] Improved error messages with clearer descriptions
- [Desktop] Optimized tray menu state refresh to reduce frequent refreshes causing the menu to close unexpectedly
- [Desktop] Launcher footer shortcut hints can now be collapsed to reduce visual clutter
- [Desktop] Improved keyword extraction quality by automatically filtering URLs, file paths, and other noise
- [CLI] Added 30s connection timeout and 60s tool call timeout to prevent process hanging during Agent calls
- [CLI] Error messages improved with troubleshooting advice and
linkly doctorguidance on connection failure
- [Desktop] Fixed settings panel occasionally displaying in English
- [Desktop] Fixed brief flash of “no results found” while typing search keywords
- [Desktop] Fixed DOCX document headings not being correctly extracted as Markdown format
- [Desktop] Fixed some documents (CSV, images with OCR in progress) failing to preview
- [Desktop] Fixed missing borders on the search box and onboarding page on Windows/Linux
- [Desktop] Fixed title and path text overflow in search results
- [MCP] Fixed occasional request timeout or no response issues with tunnel
- [CLI] Fixed unable to connect with certain custom port configurations
- [Bug Fix] Fixed Windows cold-start issue where the launcher failed to appear or froze immediately after launch
- [Bug Fix] Fixed Windows tray icon briefly showing an old icon on startup
- [Improved] MCP settings page copy improved with integration-related links
- [Improved] Onboarding now requires explicit usage selection before proceeding
- [Improved] Significantly faster OCR image recognition: automatically skips small icons and thumbnails, ~3x faster processing for high-resolution images, reduced CPU usage
- [Improved] Better search result quality: images with no text content no longer occupy search result slots, more accurate semantic search
- [Bug Fix] Fixed an issue where images pending indexing might not be processed after OCR model finished loading
- [Bug Fix] Fixed CLI failing to run on some OpenClaw host Linux systems due to GLIBC version incompatibility
🎉 Linkly AI can now recognize text in images!🚀 New Features:
- Local OCR support — automatically recognize text in PNG, JPG, BMP, WEBP images and build searchable index, supporting Chinese, English, Japanese, and Latin languages
- Redesigned onboarding flow with a conversational typing effect
- Shortcuts settings page showing all keyboard shortcuts
- System notification on first launch after update, with an update banner in the Launcher for quick access to the changelog
- Changelog link added to the About page
- Remote tunnel connection stability improved with automatic reconnection
- Colored brand icon for system tray on Windows/Linux
- CLI search filter now supports image document type
- Fixed Metal GPU assertion crash on app exit (macOS)
- Fixed incorrect document titles in some cases
- [Bug Fix] Fixed a visual issue where a gray border appeared around the window on Windows
- [Bug Fix] Fixed tunnel toggle state not syncing after the backend auto-reconnects
- [Bug Fix] Fixed CLI using the wrong health endpoint in
--remotemode
🚀 Major update — Linkly AI is now securely accessible over the internet!🚀 New Features:
- MCP now supports remote connections: access your local knowledge base directly from cloud AI assistants and Agents like ChatGPT, Claude, OpenClaw, and more
- MCP now supports LAN connections: share your MCP knowledge base service within your local network for multi-device and Agent access
- CLI adds remote mode: connect to your knowledge base from any computer via
linkly authand--remote, making it easy for Agents to call - New AI tool integration guides added to the docs site, including ChatGPT, Claude, Cursor, Windsurf, GitHub Copilot, OpenClaw, n8n, Raycast, and more
- Web Dashboard adds tunnel creation and remote call statistics panel
- Shimmer animation added to the indexing progress bar
- Indexing progress now shows separately by search type (keyword / natural language)
- Skip embedding model warm-up when vector search is disabled, speeding up startup
- MCP settings area redesigned with collapsible card layout
- Fixed cache consistency and space not being released after document deletion
- Fixed ghost records of deleted documents appearing in search results
- Fixed long loading times when reading documents with missing cache (now silently repairs in background, available on next search)
- Fixed old indexing tasks not being interrupted when switching watch folders
- Fixed settings page content area layout shift
- Fixed Windows shortcut key incorrectly using Win key instead of Ctrl key
- Fixed “VCOMP140.DLL not found” error on Windows after installation — the installer now automatically installs the VC++ runtime dependency
- [New] Search results auto-deduplication: duplicate results with the same filename and size are merged for cleaner results
- [Improved] Faster indexing with reduced resource usage during document processing
- [Improved] Simplified tray menu indexing status display with a new “View Index” shortcut
- [New] Added grep tool to MCP and CLI — locate specific lines in documents by regex pattern. AI Agents can now pinpoint target content without reading page by page, significantly reducing tool calls and context consumption
- [New] CLI now available via Homebrew and crates.io
- [New] Added index management page with index statistics and one-click rebuild
- [New] Added CLI and Skills quick links to MCP settings page
- [New] Added anonymous usage data collection with opt-in/opt-out toggle in settings (privacy-first, requires user consent)
- [Improved] Unified indexing progress display across tray and settings page
- [Bug Fix] Fixed index and extracted cache not being cleaned up after document deletion
- [Bug Fix] Fixed PDF indexing failure on Windows/Linux
- [Bug Fix] Fixed Launcher window not showing on Windows startup
- [Bug Fix] Fixed inconsistent keyboard shortcuts across platforms
- [Bug Fix] Fixed incorrect x86_64 download link on the website
- [Bug Fix] Fixed broken links in website header and footer
- [New] Added macOS Intel (x64) build — Intel Mac users can now download and use Linkly AI
- [Bug Fix] Fixed an issue where the index pipeline was not triggered after file watcher detected changes, and improved directory deletion handling
- [New] Released Linkly AI Skills — AI assistants can now better leverage Linkly AI’s tool workflow
- [New] Released Linkly AI CLI tool — AI assistants can directly call the CLI for document search and reading
- [New] CLI supports automatic discovery and connection to the app
- [Improved] MCP tools now support structured output format
- [Bug Fix] Fixed an issue where dragging the window on Windows would unexpectedly close it
- [Bug Fix] Fixed transparent window and window dragging compatibility issues on Windows
- [New] New 4-step setup wizard with permission checks for a smoother first-use experience
- [New] Added copy file path keyboard shortcut
- [New] Support for controlling macOS Dock icon visibility
- [Improved] MCP outline tool now supports tree-format output, enabling AI to better understand document structure
- [Improved] Improved PDF outline extraction accuracy
- [Improved] Tray menu now supports multiple languages
- [Improved] Optimized indexing performance with reduced resource usage
- [Improved] Optimized MCP tool descriptions for more accurate AI invocations
- [Improved] Search result scores now displayed as percentages for better clarity
- [Bug Fix] Fixed title misdetection for CJK (Chinese, Japanese, Korean) text
- [Bug Fix] Improved window positioning in multi-monitor setups
- [New] Added MCP server — AI assistants can now directly search and read your local documents
- [New] Support for hybrid keyword and semantic search for more comprehensive results
- [New] Added document outline extraction
- [New] Added multi-language support
- [New] Support for custom global shortcuts
- [Improved] Upgraded semantic search engine for better search quality
- [Improved] Improved Chinese word segmentation and keyword extraction quality
- [New] Added full-text search engine with support for searching body content of PDF, Word, and other documents
- [New] Launcher integrated with search, with result preview support
- [Improved] Redesigned search result layout
- [Improved] Window theme now automatically follows app settings
The first usable version of Linkly AI Desktop, supporting macOS, Windows, and Linux.
- [New] Automatic scanning of specified directories to build file indexes with incremental sync
- [New] Brand new launcher interface with global shortcut for quick access
- [New] Built-in auto-update with new version notifications via the tray menu
- [New] Support for general settings and folder management

