Linkly AI — Local Document Search

Linkly AI indexes documents on the user's local machine (PDF, Markdown, DOCX, TXT, HTML, etc.) and 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 (from the linkly-ai MCP server) are accessible in the current environment.

2. Pick a mode