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 Library

Open Library from the main window’s sidebar and switch the tab at the top of the left column from Files to Libraries. Your existing libraries are listed under My libraries (empty on first use).
2

Create a New Library

Click the + (New library) button to the right of My libraries. In the Create Library dialog, fill in:
  • Title (required): The display name, e.g. “Product notes”, up to 100 characters
  • Identifier (required): A unique identifier for the library. It is generated automatically as you type the title, and you can edit it. It must be 6–60 characters, use only lowercase letters, numbers, and hyphens, and start and end with a letter or number (e.g. my-research, work-2024)
  • Description (optional): A brief description of the library’s purpose
The identifier doubles as the filter parameter when searching, so keep it short and memorable. If you change it after creation, @ references in past conversations and configurations in external MCP clients will stop working.
3

Add Folders

Once created, the library’s page opens. Click the gear icon in the top right to open Library settings, then click Add Folder and pick a folder in the system dialog; you can also drag a folder straight in.A library can contain multiple folders. Once added, Linkly AI will automatically scan and index the documents within.

Managing Libraries

Click the gear icon in the top right of a library’s page to open Library settings, where you can:
  • Edit: Click Edit name and description next to the title to change the library’s title, identifier, or description
  • Remove a folder: Click the Remove folder icon next to a folder to unlink it from the library (the actual files are not deleted)
  • Delete a library: Click Delete in the Delete this library row 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. An indigo badge appears on the left side of the search box, indicating the search scope is restricted. The badge shows an @ icon and the library title; when the title differs from the identifier, the identifier follows in smaller text.
3

Enter Your Query

Search within the restricted scope. Results come only from what that library includes — its folders, plus any notes or clips brought in by a tag filter.
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

Search by Library

Combined with path filtering:

Pushing to the cloud

A local library can be pushed to the cloud in its entirety, becoming a copy that’s online 24/7 — your AI assistant can search it with your computer shut down and the app closed, and you can share it with other people. It works on free accounts.

Using Cloud Libraries

Creating, pushing, automatic sync, linking someone else’s library, publishing openly or by invitation — the whole workflow is covered here.

FAQ

No. If the documents in a folder have already been indexed through the folder management feature, creating a library will not trigger duplicate indexing. Libraries simply add a logical grouping layer on top of existing indexes.
Folders added to a library automatically appear in the folder management list — a library is essentially a logical grouping of folders and is an optional feature. A library can also pull in part of your notes or clips by tag, without adding a whole folder.Adding folders directly works for most users: folders are global and support local search as well as remote access via MCP tunnel.Libraries are useful when you need topic-based search isolation, for example separating “work” and “academic” documents. Beyond that, only a library can be pushed to the cloud — if you want a set of material online 24/7 independently of your machine, or shared with other people, it has to be organised into a library first.If you don’t have specific categorization needs, you can use Linkly AI perfectly well without creating any libraries.