# AIエージェントの使い方

このページでは、Codex、Claude Code、Cursor、Gemini CLIなどのAIコーディングアシスタントで `ml-cli` を使用する方法を説明します。

## エージェントにコピー

以下のテキストをコピーしてAIアシスタントに貼り付けると、MoreLogin CLIが自動的にセットアップされます：

```text
This template's language is not my preference. Before your first substantive reply, detect and use my OS UI language (Windows: `Get-UICulture`, then `Get-Culture`); if unavailable, use my latest non-template message's language.

Follow the MoreLogin installation, verification, and `ml-cli` usage guide:
https://github.com/MoreLoginBrowser/morelogin-skills/blob/main/skills/morelogin-setup/install.md

Keep commands, paths, JSON/API fields, and original MoreLogin responses unchanged. Ask before permissions, login/security steps, downloads, installation, GUI launches, or state changes.
```

インストール済みのCLIから同じテキストを生成することもできます：

```bash
ml-cli install-prompt
```

## Agent Guide コマンド

インストール後、エージェントは組み込みガイドを読む必要があります：

```bash
ml-cli agent-guide
```

ガイドはエージェントに以下を伝えます：

- `ml-cli` をいつ使うか
- コマンド形式を発見する方法
- 自然言語をコマンドにマッピングする方法
- いつ確認を求めるか
- `connect EPERM 127.0.0.1:40000` などのローカルサンドボックスエラーの処理方法


## Doctor コマンド

`doctor` を使用してローカルAPI接続を確認します：

```bash
ml-cli doctor
ml-cli doctor --output-json
```

`doctor` はポート検出を確認し、MoreLoginのローカルステータスエンドポイントを呼び出します。

## ブラウザプロファイルの便利コマンド

ユーザーが名前でプロファイルを参照する場合、これらのコマンドを使用します：

```bash
ml-cli env find --name P-1
ml-cli env find --keyword Amazon
ml-cli env open --name P-1
ml-cli env open --keyword "team-a"
ml-cli env open --name P-1 --exact
```

`env find --keyword` は、MoreLoginローカルAPIを通じて環境名、グループ名、タグ名、備考を検索します。
`env open` は、正確に1つの候補が一致した場合にのみプロファイルを起動します。複数のプロファイルが一致する場合、候補リストを表示して何も起動せずに終了します。

## クラウドフォンの便利コマンド

ユーザーが名前でクラウドフォンを参照する場合、これらのコマンドを使用します：

```bash
ml-cli cloudphone find --name CP-1
ml-cli cloudphone find --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1
ml-cli --timeout 120 cloudphone open --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --headless false
ml-cli --timeout 30 cloudphone close --name CP-1
ml-cli --timeout 30 cloudphone close --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --exact
```

`cloudphone find --keyword` は、MoreLoginローカルAPIを通じてクラウドフォン名、グループ名、タグ名、備考を検索します。
`cloudphone open` と `cloudphone close` は、正確に1つの候補が一致した場合にのみ動作します。複数のクラウドフォンが一致する場合、候補リストを表示して状態を変更せずに終了します。
`--headless` について：`false` はクラウドフォンのウィンドウを表示し、`true` は表示しません。APIのデフォルト値は `true` です。

## 自然言語の例

セットアップ後、以下のように質問できます：

```text
MoreLoginの最初のページにブラウザプロファイルはいくつありますか？
```

```text
MoreLoginブラウザプロファイルの最初のページを表示してください。プロファイル名、ID、ステータスを含めてください。
```

```text
P-1プロファイルを開いてください。
```

```text
P-1プロファイルがすでに実行中かどうか確認してください。
```

```text
P-1プロファイルを閉じてください。
```

```text
名前にAmazonを含むブラウザプロファイルを検索してください。
```

```text
環境名、グループ名、タグ名、または備考にAmazonを含むプロファイルを検索してください。
```

```text
グループまたはタグにAmazonを含むブラウザ環境を開いてください。複数ある場合は、まず候補を表示してください。
```

```text
最初のブラウザプロファイルを起動して、デバッグポートを教えてください。
```

```text
MoreLoginのすべてのグループを表示してください。
```

```text
MoreLoginのすべてのタグを表示してください。
```

```text
プロキシレコードの最初のページを表示してください。
```

```text
クラウドフォンリストを表示してください。
```

```text
CP-1クラウドフォンを開いてください。
```

```text
グループ、タグ、または備考にAndroidを含むクラウドフォンを検索してください。
```

```text
名前、グループ、タグ、または備考にCP-204を含むクラウドフォンを開き、ウィンドウを表示してください。
```

```text
CP-1クラウドフォンを閉じてください。
```

```text
ml-cliのヘルプを読んで、一般的なブラウザプロファイルコマンドをまとめてください。
```