Skip to main content

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.

2026-04-20
v0.3.5
  • [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)
2026-04-17
v0.3.4
  • [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
2026-04-09
v0.3.3
  • [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
2026-04-02
v0.3.2
  • [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
2026-03-31
v0.3.1
  • [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
2026-03-30
v0.3.0
📚 Libraries are here! Organize your documents into libraries for more precise search within specific domains.
This upgrade will update existing index structures. Search results may be inaccurate during the update — please wait for it to complete before continuing use.
🚀 New Features:
  • [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_libraries tool for listing all knowledge libraries, usable with search and other tools
  • [MCP] New explore overview tool — AI Agents can quickly understand the topic distribution, directory structure, and top keywords of a document collection or specific library
  • [MCP] search tool now supports library and path_glob filter parameters
  • [CLI] New list-libraries and explore commands
  • [CLI] search supports --library and --path-glob flags
  • [CLI] New linkly doctor diagnostic 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-libraries and explore
  • [Web] Dashboard now supports username settings for the cloud library namespace
✨ Improvements:
  • [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 doctor guidance on connection failure
🐛 Bug Fixes:
  • [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
2026-03-21
v0.2.4
  • [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
2026-03-19
v0.2.3
  • [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
2026-03-19
v0.2.2
🎉 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
✨ Improvements:
  • 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
🐛 Bug Fixes:
  • Fixed Metal GPU assertion crash on app exit (macOS)
  • Fixed incorrect document titles in some cases
2026-03-14
v0.2.1
  • [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 --remote mode
2026-03-12
v0.2.0
🚀 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 auth and --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
✨ Improvements:
  • 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
🐛 Bug Fixes:
  • 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
2026-03-10
v0.1.11
  • [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
2026-03-09
v0.1.10
  • [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
2026-03-06
v0.1.9
  • [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
2026-03-05
v0.1.8
  • [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
2026-03-03
v0.1.7
  • [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
2026-03-03
v0.1.6
  • [Bug Fix] Fixed transparent window and window dragging compatibility issues on Windows
2026-02-13
v0.1.5
  • [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
2026-02-11
v0.1.4
  • [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
2026-02-10
v0.1.3
  • [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
2026-02-07
v0.1.2
  • [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
2026-02-07
v0.1.1
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