Skip to main content

​
What Are Libraries

A Library is a named container in Linkly AI for organizing documents. You can group documents on the same topic into a library and filter searches by library to quickly locate what you need.

Topic Isolation

Keep “work documents” and “research papers” separate — searches won’t mix them up

Precise Search

Restrict search scope to a specific library in the Launcher, MCP, or CLI
Libraries are an optional advanced feature. Not creating any libraries won’t affect existing functionality — global search remains the default experience. Libraries are ideal for users with many documents who need organized categories.

​
Use Cases

  • Researchers: Organize papers by topic into libraries like ml-papers, neuroscience, etc.
  • Developers: Separate project docs, API specs, and meeting notes
  • Team Collaboration: Create dedicated libraries per project so AI assistants only search relevant documents via MCP
  • Personal Knowledge Management: Categorize notes, book excerpts, and reference materials

​
Creating a Library

1

Open the Libraries Page

Go to Settings → Libraries. You’ll see the library list page (empty on first use).
2

Create a New Library

Click the New Library button in the top right corner. In the dialog, fill in:
  • Name (required): A unique identifier for the library. Only lowercase letters, numbers, and hyphens are allowed (e.g. my-research, work-2024)
  • Description (optional): A brief description of the library’s purpose
The name uses slug format and doubles as the filter parameter when searching. Keep it short and memorable.
3

Add Folders

After creation, enter the library detail page and click the Add Folder button to select a folder from the system file picker.A library can contain multiple folders. Once added, Linkly AI will automatically scan and index the documents within.

​
Managing Libraries

On the library detail page, you can:
  • Edit: Click the pencil icon to modify the name or description
  • Remove a folder: Click the delete icon next to a folder to unlink it from the library (the actual files are not deleted)
  • Delete a library: Click the delete icon and confirm to remove the entire library. Indexed documents are unaffected and can still be found via global search

​
Scoped Search in the Launcher

The Launcher supports @-triggered library-scoped search:
1

Type @ to Enter Library Selection

Type @ in the Launcher search box. The view switches to a library candidate list. Continue typing to filter by name.
2

Select a Library

Click or press Enter to select a library. A blue badge appears on the left side of the search box (e.g. @my-research), indicating the search scope is restricted.
3

Enter Your Query

Search within the restricted scope. Results come only from folders included in that library.
4

Exit Scoped Search

Press the Backspace key when the search box is empty, or click the back button on the left to return to global search.

​
Using Libraries with AI Assistants

AI assistants connected to Linkly AI (such as OpenClaw, Claude, Cursor, etc.) can search within specific libraries. Simply tell them the search scope in natural language:

Search by Library

“Search my ml-papers library for documents about attention mechanisms”

List Available Libraries

“List all my libraries”

Combined Filtering

“Search for transformer-related PDF files in my ml-papers library”
The AI assistant will automatically invoke the appropriate MCP or CLI tools to complete the search.

​
Using Libraries with the CLI

​
List Libraries

linkly list-libraries

​
Search by Library

linkly search "attention mechanism" --library ml-papers
Combined with path filtering: 
linkly search "transformer" --library ml-papers --path-glob "*.pdf"
Libraries will soon support cloud push for 24/7 online access.