# CLI エージェント

ターミナルから使っているエージェントを、執筆ワークスペースの中で使います。

インストール済みのエージェントを Oleafly に持ち込めます。 **CLI エージェント**モードは、そのエージェントのランタイムとサインインを使うので、普段使っているツールで原稿のそばで作業できます。

![設定 → AI アシスタント → CLI エージェント。最初に上部でインストール済みのエージェントを確認し、続いてエージェントを展開してセットアップを完了します。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-cli-agents-dark-window-v2.png#view=519,89,883,902)

## エージェントに接続する

1. **設定 → AI アシスタント → CLI エージェント**を開き、 **インストール済みのエージェントを確認**を選びます。
2. 使うエージェントを展開します。 **プログラム**の行に、Oleafly が見つけたプログラムとその場所が表示されます。
3. **テスト**を選びます。カードにブリッジが必要と表示されている場合は、先に**ブリッジをインストール**を選びます。
4. エージェント自身のコマンドラインツールでサインインします。カードに**サインインのコマンド**が表示され、プロジェクトを開いていれば、 **サインイン用のターミナルを開く**で、それを実行するためのターミナルが開きます。
5. アシスタントを開き、 **CLI エージェント**に切り替えて、エージェントを選びます。
6. プロジェクトの構成を説明してもらう、1 つの段落を修正してもらうといった、小さな作業から始めます。

まだ準備ができていないエージェントに切り替えると、アシスタントに、何が足りないかを示すセットアップのカードが表示されます。カードの **Claude Code をセットアップ** のようなボタンを押すと、設定でそのエージェントが開きます。足りないのがブリッジだけの場合は、カードの**ブリッジをインストール**でインストールできます。

認証、モデルへのアクセス、課金は、選んだエージェントの側で扱われます。CLI に対応したアカウントやサブスクリプションは、そのプロバイダの規約に従って使えます。Oleafly が別の AI サブスクリプションを追加することはありません。

## プログラムを選ぶ

カードの**プログラム**の下に、Oleafly が起動するファイルと、その入手元が表示されます。 **自動で検出**か**手動で選択**か **Oleafly がインストール** のいずれかです。一部のエージェントでは、この行は代わりに **ACP ブリッジ**の詳細の中にあります。

別のコピーを使うには、 **選択…** を選んでファイルを指定します。Oleafly が何も見つけられなかった場合、その行に**このコンピュータに見つかりません**と表示され、場所を入力する欄が出ます。パスを入力または貼り付けて、Enter を押すか**テスト**を選びます。選んだ、または入力したファイルは、テストに合格した場合にのみ保存されます。 **自動検出を使用**を選ぶと、手動での選択が取り消されます。

Oleafly は、インストーラーがエージェントを置くフォルダを探します。

- Windows では、npm、pnpm、Scoop、winget などで、どのドライブにインストールしたエージェントも見つけます。検索パスは毎回読み直すので、Oleafly を開いている間にインストールしたエージェントも、 **インストール済みのエージェントを確認**で見つかります。
- macOS では、`~/.local/bin` や nvm のフォルダなど、通常はシェルだけが把握しているフォルダにあるエージェントも、Dock や Finder から Oleafly を開いた場合でも見つけます。

名前は合っているのに Oleafly が使えないファイルが見つかった場合、セットアップに、何が見つかったか、なぜ使えないかが表示されます。Windows でよくあるのは、Oleafly が `.cmd` か `.exe` を必要としているのに、PowerShell スクリプトが見つかるケースです。 **Oleafly がスキップしたファイル**には、そうしたファイルが理由とともに一覧表示されます。たとえば、フォルダ、デスクトップアプリ、`node` などのシェルやランタイム、ネットワーク上のコピーです。

設定のパスは、ポインタを合わせるか Tab キーで移動するまでぼかされています。そのため、設定のスクリーンショットを撮っても、ファイルの場所は写りません。

## エージェントをテストする

**テスト**は、プロジェクトから離れた Oleafly 専用の空のフォルダでエージェントを起動し、応答を待ちます。何も保存されません。合格すると、エージェントの名前とバージョンが表示されます。失敗した場合は、理由を述べる 1 文と、試すことが 1 つ表示されます。

| テストの結果 | 試すこと |
| --- | --- |
| そこにファイルがない、またはフォルダ、デスクトップアプリ、Oleafly が起動できないファイルである | **選択…** を選び、プログラム本体を指定する |
| ブリッジがまだインストールされていない | **ブリッジをインストール** |
| エージェントに Node.js、またはより新しいバージョンの Node.js が必要 | **Node.js を入手** |
| エージェントは起動したが、応答しなかった、途中で止まった、または Oleafly が読み取れない応答を返した | **詳細をコピー**する、または**ターミナルを開く**を選んで自分で実行する |

選んだファイルが、ファイル自体以外の理由でテストに失敗した場合、 **このまま使用**を選べば、そのまま保存されます。

## エージェントの一覧

| エージェント | CLI コマンド |
| --- | --- |
| Claude Code | `claude` |
| Codex CLI | `codex` |
| Gemini CLI | `gemini` |
| Pi | `pi` |
| OpenCode | `opencode` |
| OpenClaw | `openclaw` |
| Cline | `cline` |
| Hermes Agent | `hermes` |
| CodeBuddy | `codebuddy` |
| Kimi Code | `kimi` |
| Grok Build | `grok` |
| Cursor | `cursor-agent` または `agent` |
| DeepSeek Harness | `dsh` |
| Qoder | `qodercli` |

この一覧は、対応している起動方法を示します。利用できるモデル、添付、セッションの再開、使用状況の報告は、エージェントが提供する機能によって決まります。足りない要件は、セッションを始める前にセットアップが知らせます。

Pi は pi-acp ブリッジ (バージョン 0.0.34) を通して動作し、Oleafly がそのブリッジに、お使いの Pi のプログラムを指定します。Windows では、名前にスペースを含むプロジェクトフォルダも扱えます。

## 原稿のそばで作業する

エージェントに具体的な依頼を出し、返信、ツールの動作、許可の確認をアシスタントパネルで追います。できあがったソースを開き、Oleafly でコンパイルします。

> イントロダクションと手法を読んでください。用語の導入に一貫性がないものを、ファイルの場所とともに一覧にしてください。

別のコピーで作業して最終確認をしたい場合は、[調査タスク](/docs/research-tasks/)で利用できるエージェントを選びます。分離した作業のプラットフォーム要件は、そのページに載っています。

## 調査の出発点

新しい会話は、調査の出発点を並べたエージェントのホームページで始まります。出発点を選ぶとメッセージが入力されますが、送信はされないので、先に内容を読んで調整できます。まだ会話が開いていない場合は、会話が始まります。

| 出発点 | 依頼する内容 |
| --- | --- |
| **文献調査** | `oleafly-literature-sweep` スキルを使って、プロジェクトの研究課題について注釈付きの読書リストを作る |
| **関連研究** | `oleafly-related-work` を使って、読書リストと参考文献から関連研究のセクションを下書きする |
| **引用チェック** | `oleafly-verify-claims` を使って、原稿の主張を引用元と照らして確認する |
| **原稿レビュー** | `oleafly-review-manuscript` を使って、原稿全体をレビューする |
| **再現性チェック** | 各結果を再現するために足りないもの (コード、データ、ソフトウェアのバージョン、乱数シード、ビルド手順) を洗い出す |
| **図のチェック** | すべての図と表を確認する。キャプション、ラベル、相互参照、軸ラベルと単位、読みやすさ、グレースケールでも判別できる色を見る |
| **Git レビュー** | 未コミットの変更と最近のコミットをまとめ、意図していないように見える編集を指摘する。Git リポジトリでのみ表示される |
| **参考文献の整理** | **参考文献ライブラリの整理**を開く。変更をプレビューしたうえで、引用キーを統一し、重複を取り除く |

チェックと原稿レビューでは、エージェントは原稿ファイルには手を付けず、結果を `research/` 内のファイル (たとえば `research/figure-audit.md`) に書き出します。

出発点またはホームページのスキル一覧から選んだスキルは、メッセージの上にチップとして表示されます。Oleafly はメッセージと一緒にスキルの指示も送るので、Pi のように Oleafly のツールを使えないエージェントでも、その指示に従えます。チップをクリックすると外せます。そのプロジェクトでスキルがオフになっている場合、出発点はスキルなしでメッセージを入力します。

## 許可の要求

エージェントが実行の前に確認を求めると、カードに「エージェントが許可を求めています」と表示され、エージェント自身の選択肢が示されます。要求がファイルを変更するものである場合は、カードにそのファイルが一覧表示されます。 **変更を表示**を押すと、そのファイルの差分が開くので、答える前に内容を読めます。大きすぎて表示できない変更にはその旨が表示され、やり取りが終わったあとで確認できます。 **閉じる**を押すと、許可せずに要求を取り消します。2 分間放置した要求は期限切れになり、エージェントはもう一度確認を求める必要があります。

## 変更を確認して元に戻す

ファイルを変更したやり取りのあとには、返信の下に変更数が表示されます。 **レビュー**で個々の変更を確認でき、 **元に戻す**と**やり直す**は、ファイルごと、またはやり取り全体に対して使えます。仕組みと対象外になるものは、[やり取りを確認して元に戻す](/docs/ai-chat/#review-and-undo-a-turn)で説明しています。

## 会話と書き出し

アシスタントのヘッダーには、 **新しい会話**と**保存された会話**と**エージェントのセットアップ**があります。各会話には、始まったときにプロジェクトがあった Git のコミットが記録されます。

Oleafly の外にコピーを残すには、 **保存された会話**を開いて **会話を書き出す…** を選び、保存ダイアログで Markdown か JSON を選びます。Markdown ファイルの冒頭には、プロジェクト、エージェント、モデル、会話を始めたときのコミット (未コミットの変更があればその旨も記載)、開始日時と最終更新日時が書かれます。そのあとに、メッセージ、スキル、ツール呼び出し、変更されたファイルが続きます。JSON には完全な記録が入ります。

## カスタムエージェント

**ほかのエージェントを探す**を選ぶと、ほかのチームが公開しているエージェントを ACP レジストリから検索できます。 **カスタムエージェントを追加**を選ぶと、定義を自分で貼り付けられます。実行する前に、実行ファイルまたはパッケージ、引数、接続要件を確認してください。定義を登録しても、エージェントのインストールや起動は行われません。

## 代わりに外部クライアントを使う

エージェント自身の画面で作業したい場合は、MCP で接続します。[Oleafly の MCP サーバー](/docs/mcp/)は、Oleafly を開いている間、アプリのプロジェクトツールをエージェントに提供します。[`oleafly` コマンド](/docs/cli/#connect-an-agent-over-mcp)はアプリを閉じていても使え、[`oleafly-cli` スキル](/docs/cli/#the-oleafly-cli-skill)はそのコマンドをエージェントに教えます。