Linkly AILinkly AI
Back to blog

ターミナルを離れずに、AIにPC上のすべてのドキュメントを検索させる

·Linkly AI·

Linkly AI Desktop はバックグラウンドでドキュメントのインデックスを構築しています。では、そのインデックスをどう活用するのか?

一つは MCP プロトコルを通じて AI アシスタントに直接呼び出してもらう方法。もう一つ、もっと直接的な方法——ターミナルからコマンドラインで使うことです。

Linkly AI CLI がそのコマンドラインツールです。Rust で書かれ、バイナリはわずか数 MB。MCP プロトコルでデスクトップアプリと接続し、ドキュメント検索をターミナルに持ち込みます。

3つのコアコマンド

CLI は Outlines Index の段階的ワークフローに従います:search → outline → read

search — ドキュメントを検索

$ linkly search "Docker デプロイ" --limit 5

Found 5 results:

#1  本番環境デプロイガイド
    doc_id: 1044 | type: pdf | words: 12,400 | lines: 580
    has_outline: yes | relevance: 0.89

#2  Docker Compose 設定ガイド
    doc_id: 591 | type: md | words: 1,200 | lines: 85
    has_outline: yes | relevance: 0.82
...

ドキュメントタイプでフィルタリング:

$ linkly search "API ドキュメント" --type pdf,md,docx

outline — ドキュメントの構造を確認

$ linkly outline 1044

[1] 概要 [L1-30, 30行]
[2] 環境構築 [L31-80, 50行]
[3] Docker デプロイ [L81-250, 170行]
  [3.1] Dockerfile 設定 [L85-140, 56行]
  [3.2] Docker Compose [L141-220, 80行]
  [3.3] 環境変数 [L221-250, 30行]
[4] Kubernetes デプロイ [L251-450, 200行]
...

複数ドキュメントのアウトラインを一括表示:

$ linkly outline 1044 591 302

read — 内容を読む

$ linkly read 1044 --offset 141 --limit 80

141 | ## Docker Compose
142 |
143 | docker-compose でマルチコンテナデプロイを管理...
...
220 | `docker-compose up -d` でサービスを起動。

Showing lines 141-220 of 580.

目的のセクションを見つけたら、ピンポイントで読み取り。PDF リーダーを開く必要もなければ、ターミナルから離れる必要もありません。

MCP ブリッジ:AI ツールとの接続

CLI の最も重要な機能の一つが mcp コマンドです:

$ linkly mcp

stdio MCP サーバーモードで起動し、Linkly AI の HTTP MCP を stdio MCP に変換します。stdio MCP に対応するあらゆる AI クライアントが接続できます。

Claude Desktop の設定

{
  "mcpServers": {
    "linkly-ai": {
      "command": "linkly",
      "args": ["mcp"]
    }
  }
}

Cursor の設定:Settings → MCP Servers → Add Server で linkly mcp と入力。

設定後、Claude Desktop や Cursor からあなたのコンピューター上のドキュメントを直接検索・閲覧できるようになります。

その他の便利な機能

ステータス確認

$ linkly status

CLI version:  0.1.5
App version:  0.1.9
Endpoint:     http://127.0.0.1:60606/mcp
Documents:    3,260
Status:       Up to date (watching)

JSON 出力(スクリプト連携用):

$ linkly search "契約書" --json | jq '.results[0].title'

LAN 検索(他のデバイスのドキュメントにアクセス):

$ linkly search "レポート" --endpoint http://192.168.1.100:60606/mcp

セルフアップデート

$ linkly self-update

インストール

# macOS / Linux(推奨)
curl -sSL https://updater.linkly.ai/cli/install.sh | sh

# Homebrew
brew tap LinklyAI/tap && brew install linkly

# Cargo
cargo install linkly-ai-cli

# Windows (PowerShell)
irm https://updater.linkly.ai/cli/install.ps1 | iex

インストール後、Linkly AI Desktop が起動していることを確認してください。CLI は ~/.linkly/port ファイルを通じてデスクトップアプリを自動検出します。設定不要です。


Linkly AI チーム開発。CLI は GitHub でオープンソースとして公開しています。