Linkly AI — Document Search (Local + Cloud)

Linkly AI indexes documents on the user's local machine (PDF, Markdown, DOCX, PPTX, EPUB, TXT, HTML, etc.) and can also reach cloud libraries the user has linked via Linkly Web. It exposes them through a progressive disclosure workflow: search → grep or outline → read.

Environment Detection

Before executing any document operation, detect what's available and pick a mode. CLI and MCP are two independent access paths — check both, don't treat MCP as a CLI fallback.

1. Check what's available

Run both checks independently (skip a check if its prerequisite isn't there):

• CLI: if Bash is available, run linkly --version. Success → CLI is installed. Then run linkly status to confirm the desktop app is reachable; if the status reports a connection problem, run linkly doctor (see references/troubleshooting.md).
• MCP: check whether MCP tools named search, find_paths, outline, grep, read, list_libraries, and explore are accessible in the current environment. They may come from the linkly-ai server (local Desktop MCP) or the linkly-ai-cloud server (the mcp.linkly.ai cloud gateway, which exposes both local and linked cloud libraries).

2. Pick a mode