Linkly AI CLI
Клиент Linkly AI: агент ищет по локальным документам, читает их и сохраняет заметки, MCP-мост для Claude Desktop и Cursor
- 43 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент читает проиндексированные документы и через `note-save` записывает заметки на настольную машину
- Режим `--remote` ходит в облачный шлюз с ключом API, ключ хранится в `~/.linkly/credentials.json`
Установка
- Работает в
Ручная установка
curl -sSL https://updater.linkly.ai/cli/install.sh | shСкрипт для macOS и Linux. Для Windows в README есть вариант с PowerShell.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает проиндексированные документы и через `note-save` записывает заметки на настольную машину
- Режим `--remote` ходит в облачный шлюз с ключом API, ключ хранится в `~/.linkly/credentials.json`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `linkly` обращается к настольному приложению Linkly AI и ищет по его индексу документов: PDF, Markdown, DOCX, PPTX, EPUB, TXT и HTML. Приложение должно быть запущено, а его MCP-сервер включен. CLI находит порт в файле `~/.linkly/port` сам. Команды `search`, `find-paths`, `outline`, `grep`, `read` и `list` покрывают весь путь от поиска до чтения: фильтры по типу, библиотеке, шаблону пути и дате изменения, сортировка по времени, чтение диапазона строк. Команда `note-save` создает и правит заметки в формате Markdown с проверкой версии при правке. Режим `--json` выводит один объект на результат, `--exit-code` возвращает 0, 1 или 2. Команда `linkly mcp` запускает мост MCP по stdio для Claude Desktop, Cursor и других клиентов. Кроме локального приложения клиент подключается к устройству в локальной сети (`--lan`) или к облачному шлюзу через туннель (`--remote`). Подкоманды `linkly skills` ставят и обновляют скилл `linkly-ai`, который учит агента пользоваться этими командами.
Для кого. Тем, кто держит рабочие материалы в PDF, Markdown и Office-файлах и хочет, чтобы агент искал по ним из терминала.
Подходит, если
- В папке с отчетами и конспектами нужно найти документ по смыслу, а не по имени файла
- Агент должен вынуть из длинного PDF только раздел по заголовку или строки с совпадением
- Заметки из чата с агентом сохраняют в Markdown на настольной машине
- Claude Desktop или Cursor подключают к локальной базе документов через готовый MCP-мост
- Документы лежат на другом устройстве в той же сети, и их ищут по LAN-токену
Не подходит, если
- Настольного приложения Linkly AI нет: CLI сам документы не индексирует и работает как клиент
- Нужен поиск по коду репозитория: для этого подойдут `grep` и инструменты самого агента
- Установка через `curl ... | sh` в вашей среде запрещена: берите пакет Homebrew, Cargo или готовый архив с релизов
Пример запроса к агенту
Найди в моих документах квартальный отчет за 2024 год, покажи оглавление и прочитай раздел про расходы.Ограничения
Без запущенного приложения Linkly AI с включенным MCP-сервером CLI подключается только к LAN-устройству или к облаку. Для `--remote` нужен вход через `linkly auth login` или ключ API.
Заметки лежат на настольной машине, облачного хранилища заметок нет. Для `note-save` требуется приложение версии 0.11.0 или новее.
На старых версиях приложения правка заметки с `--tags` заменяет весь набор тегов.
Ссылки на документацию и каналы сообщества ведут на сайт linkly.ai.
Как отключить. Удалите мост из конфига клиента, а CLI командой `brew uninstall linkly` или `cargo uninstall linkly-ai-cli`, смотря чем ставили. Сохраненные ключи удаляет `linkly auth logout`.
Частые вопросы
Нужно ли настольное приложение Linkly AI?
Да, в режиме по умолчанию. CLI ищет приложение по файлу `~/.linkly/port`. Режимы `--lan` и `--remote` подключают устройство в сети или облачный шлюз.
Как подключить Linkly к Claude Desktop?
Добавьте в `claude_desktop_config.json` сервер с командой `linkly` и аргументом `mcp`. Для облака в аргументы дописывают `--remote`.
Что дает скилл linkly-ai?
Он объясняет агенту, как пользоваться командами CLI. Статус показывает `linkly skills status`, установку делает `linkly skills install`, обновление `linkly skills update`.
Какие форматы документов читает поиск?
PDF, Markdown, DOCX, PPTX, EPUB, TXT и HTML. Список типов передают в `--type`, например `--type pdf,md`.
Зачем флаг --client?
Он подписывает вызов именем агента в журнале доступа настольного приложения. Это метка, ничего не разрешающая. Агентам советуют передавать его всегда.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыRoam Research MCP и CLI
Roam Research MCP and CLI
Агент ищет, читает и пишет в граф Roam Research через локальный API настольного приложения, есть CLI и скилл с синтаксисом
Get笔记 CLI (getnote)
Get笔记 CLI
CLI getnote сохраняет ссылки и тексты в Get笔记 (Dedao Brain), ищет по заметкам и базам знаний, ставит пять скиллов для агентов.
Заметки, задачи, контакты и контекст проектов лежат в Markdown на вашем диске, и Claude Code с Codex читают одну и ту же память
Скилл и MCP-сервер для Claude Code: Google NotebookLM создает блокноты из ссылок и файлов, отвечает с цитатами и выдает подкасты, слайды и тесты
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
mcp-logseq — MCP-сервер для Logseq
MCP server for LogSeq
MCP-сервер для Logseq: агент читает, ищет и правит страницы и блоки графа через локальный HTTP API
Коротко о README
Документация перечисляет способы установки (скрипт, Homebrew, Cargo, архивы с релизов, сборка из исходников), команды с опциями и три режима подключения: локальный, LAN и удаленный. Отдельные разделы объясняют вход через браузер, работу агента без ожидания (`--no-wait`) и диагностику `linkly doctor`.