エージェントに送る

#指摘を確かめる

指摘 タブの各カードでできること:

• 題名と依頼をその場で直す
• 送信する / 送信しない の切り替え
• 録画を見る（その時刻へ移動）と 画像を差し替え（別のフレームを選ぶ）
• 確定する / 要確認にする、次とまとめる、削除

進み具合で絞り込む で、状態ごとに指摘を表示したり隠したりできます（たとえば、あなたの確認待ちのものだけ表示する）。すべて表示 で絞り込みを解除します。

上部には 元に戻す、保存先を開く、Agent向けにコピー、GitHub / GitLab に送る、整理、Agentへ送信 があります。指摘にならなかった発話は 除外した発話 に並び、発話を指摘に戻す で戻せます。

#内蔵のターミナルでエージェントを動かす

プロジェクトを開くと、Ferret は 設定 → Agent → プロジェクトを開いたら起動 で選んだエージェントごとにターミナルのタブを1つ開き、プロジェクトのフォルダで、そのエージェントの普通のモードで起動します。最初の設定は Claude Code と Codex です。

claude
codex

代わりに対応している一覧から好きなエージェントを選べます（選んだ順に起動します）。何も選ばないこともできます。

エージェントを1つも選んでいなければ、普通のシェルが開きます。+ メニューからは 新しいターミナル を開いたり、自分のエージェントを新しいタブで起動したり、Agent設定… に移ったりできます。メニューの検索欄では、タブ、登録した URL、ファイルも探せます。

タブにはエージェントの状態が出ます: 実行中、入力待ち、完了（未確認）、待機中。サイドバーでは、エージェントが動いているプロジェクトに印が付くので、プロジェクトを切り替えなくても分かります。

ドラッグで分割する。 タブか、ペインのつまみ（タブを分割すると出ます）をドラッグして、次の場所で離します。

• ペインの端の外側4分の1: 左に分割 / 右に分割 / 上に分割 / 下に分割
• ペインの中央: タブとして開く（ペインは分割から外れて、独立したタブになります）
• ターミナル全体を囲む細い帯: 全体の左に分割 など（ペインが2つ以上あるとき）
• タブバー: ここにタブとして置く

動かしている間もプロセスは動き続け、空になったタブは閉じます。キーボードでの分割:

#対応しているエージェント

Ferret は特定のエージェントに縛られません。下のコーディングエージェントを認識し、起動したり、Agentへ送信 のためにターミナルの中から見つけたり、インストール済みかどうかを表示したりできます。設定 → Agent には、インストール済み / 見つかりません、提供元が1行のインストーラーを公開している場合の インストール ボタン、各エージェントのコマンドと引数が並びます。

• Claude Code （新しいタブで開きます） claude
• Codex （新しいタブで開きます） codex
• Gemini CLI （新しいタブで開きます） gemini
• Cursor （新しいタブで開きます） agent
• GitHub Copilot （新しいタブで開きます） copilot
• Devin （新しいタブで開きます） devin
• OpenCode （新しいタブで開きます） opencode
• Amp （新しいタブで開きます） amp
• Droid （新しいタブで開きます） droid
• Kiro （新しいタブで開きます） kiro-cli chat
• Aider （新しいタブで開きます） aider
• Ante （新しいタブで開きます） ante
• Antigravity （新しいタブで開きます） agy
• Auggie （新しいタブで開きます） auggie
• Autohand Code （新しいタブで開きます） autohand
• BLACKBOX CLI （新しいタブで開きます） blackbox
• Cline （新しいタブで開きます） cline
• CodeBuddy （新しいタブで開きます） codebuddy
• Codebuff （新しいタブで開きます） codebuff
• Command Code （新しいタブで開きます） command-code --trust
• Continue （新しいタブで開きます） cn
• Charm (Crush) （新しいタブで開きます） crush
• DeepSeek Harness （新しいタブで開きます） dsh tui
• ForgeCode （新しいタブで開きます） forge
• Freebuff （新しいタブで開きます） freebuff
• Goose （新しいタブで開きます） goose session
• Grok （新しいタブで開きます） grok
• Hermes Agent （新しいタブで開きます） hermes --tui
• Junie CLI （新しいタブで開きます） junie
• Kilocode （新しいタブで開きます） kilo
• Kimi （新しいタブで開きます） kimi
• Letta Code （新しいタブで開きます） letta
• MiMo Code （新しいタブで開きます） mimo
• Mistral Vibe （新しいタブで開きます） vibe
• Muse （新しいタブで開きます） muse --trust-workspace
• oh-my-pi （新しいタブで開きます） omp
• OpenClaude （新しいタブで開きます） openclaude
• OpenClaw （新しいタブで開きます） openclaw chat
• OpenHands CLI （新しいタブで開きます） openhands
• Pi （新しいタブで開きます） pi
• Prime Agent （新しいタブで開きます） prime-agent
• Qoder CLI （新しいタブで開きます） qoder
• Qwen Code （新しいタブで開きます） qwen
• Roo Code CLI （新しいタブで開きます） roo
• Rovo Dev （新しいタブで開きます） acli rovodev run
• Trae CLI （新しいタブで開きます） traecli
• ZCode （新しいタブで開きます） zcode

一覧に無いときは、設定 → Agent → カスタムエージェントを追加 で、どんな CLI やラッパースクリプトでも登録できます（名前、コマンド、必要なら見分けるためのプロセス名）。settings.json の agents.customAgents に足すこともできます。Ferret の外で動くエージェントには Agent向けにコピー を使えます。

いくつかの機能はエージェントによって違い、今のところ Claude Code と Codex だけで使えます。

• アカウントと使用量: 複数のログインの切り替えと、フッターのレート制限のメーター。
• 整理: Claude Code か Codex のログイン、または自分で設定した LLM API で動きます。

#Agentへ送信 / Agent向けにコピー

1. Agentへ送信 を押します。既定（自動（今のタブか、動いている Agent））では、いま開いているターミナルのタブのエージェントか、動いているエージェントに届きます。ボタンの横の矢印（送り先の Agent を選ぶ）で、送り先のエージェントやタブを選べます。
2. Ferret はエージェントの入力欄に指示を書き込んで送信します。進み具合はターミナルで追います。

エージェントが動いていなければ、Ferret が先に起動し、準備ができしだい送ります。エージェントが権限の確認への答えを待っている間は何も送りません。先にターミナルで答えてください。

Agent向けにコピー は、ほかの場所（別のターミナル、IDE、アプリ）で動くエージェントのために、同じ指示をクリップボードに入れます。対象になるのは 送信する にした指摘だけです。動画は決して含めません。

#判定モデルでの受け入れ確認

これを入にすると、コーディングエージェントは「完了」と報告する前に、自分の作業を指摘ごとに確かめます。Ferret 自身は何も判定しません。エージェントに判定モデル（System One 互換の API ならどれでも）を渡し、すべての指摘が通るまで繰り返すよう feedback.md で指示します。

1. エージェントが指摘を実装します。
2. 指摘ごとに AFTER のスクリーンショットを撮り（BEFORE の静止画と同じビューポートとページの状態で）、指摘の文、その「完了の条件」の行、BEFORE / AFTER の画像を1つのリクエストで判定モデルに送ります。
3. P(done) がしきい値（既定 0.7）以上で、選ばれた答えが done なら、その指摘は合格です。エージェントは残りを直し、毎回すべての指摘を判定し直します。止まるのは、同じ回ですべての指摘が合格したときか、はっきり書くべき正当な理由があるときだけです（API につながらない、指摘が対象外、点数が変わらず行き詰まっている）。
4. 最後の「完了／未完了」の一覧には、指摘ごとの点数と回数が入ります。

設定 → 判定モデル で設定し、Agent への指示に判定モデルでの確認を入れる を入にします。プリセットは欄を埋めるだけで、どの欄も後から直せます。任意の接続先 は互換の API ならどれでも使えます。

Ollama を使うときは、Ollama を入れ（Clef / Clef Flash には 0.35.1 以降が必要）、ターミナルでモデルを取得します。Ferret はインストーラーを実行しません。

ollama pull clef-flash

キーは、キーの欄（ほかの API キーと一緒に保存）、名前を指定した環境変数（アプリの環境、プロジェクトの .env、または ~/.ferret/.env）、または settings.json の apiKey から読みます。追加のヘッダーでは ${VAR} で環境変数の値を使えます。

Cloudflare は System One のドキュメントと2点違います（実際の API で確認済み）。画像はデータ URI（data:image/jpeg;base64,…）でなければならず、そうでないと 422 "image must be an embedded base64 data URI" になります。また、答えは { "result": { … }, "success": true } で包まれて返ります（エラーは { "success": false, "errors": [ … ] }）。Cloudflare のプリセットは 画像の渡し方 をデータ URI にし、エージェントはそれを FERRET_DECISION_IMAGE_FORMAT として受け取り、指示では .result があればそれを読むよう伝えます。中継は行きも帰りもそのまま通します。API トークンの代わりに Global API Key を使うときは、認証 を キーなし にし、ヘッダー X-Auth-Email: ${CLOUDFLARE_EMAIL} と X-Auth-Key: ${CLOUDFLARE_API_KEY} を足します。

画像を読めるのは Clef と Clef Flash だけです。テキストのみのモデルでは BEFORE / AFTER の画像を送る を切にします。その場合エージェントはテキストだけで判定するので、確かさは下がります。

#フッターの API 使用量

判定の呼び出しは中継を通るので、Ferret が数えられます。フッターで、エージェントの使用量メーターの横にある項目に、判定モデルと、今日の呼び出し回数・トークン数・費用が出ます（たとえば clef-flash · 42 calls · 18.3k tok）。押すと、今日、今月、プロジェクト別、モデル別、種類別（判定 / 文字起こし / 整理）の集計と、直近50回の呼び出しが見られます。

費用が出るのは、API が費用を返すとき（Vercel AI Gateway は返します）か、設定 → 判定モデル で 1M トークンあたりの価格を設定したときだけです。それ以外は「—」と出ます。記録するのはメタデータ（時刻、プロジェクト、モデル、状態、待ち時間、サイズ、画像の数、トークン数、費用）だけで、画像・テキスト・キーは記録しません。記録先は ~/.ferret/usage/decision-YYYY-MM.jsonl で、月ごとに1ファイルです。

#指示を変える

設定 → Agent → Agentへの指示 を編集します。展開される変数は2つです。

空にすると既定の指示を使います。最大 2000 文字で、指示を既定に戻す で既定に戻せます。例:

Read {{relpath}} and the PNGs next to it. Fix only findings marked to send, one commit per finding, then run the tests.

この設定は settings.json の agentPrompt に保存されます。

#GitHub や GitLab に送る（Issue / PR・MR へのコメント）

GitHub に送る は、レビューを新しい Issue として、または自分の開いている Pull Request の1つへのコメントとして投稿します。認証は GitHub CLI （新しいタブで開きます） に任せます。Ferret がトークンを読んだり保存したりすることはありません。

1. gh を入れます: brew install gh（macOS）、winget install --id GitHub.cli（Windows）、またはほかの方法は cli/cli （新しいタブで開きます） を見てください。
2. 設定 → GitHub / GitLab → ターミナルでログイン が、内蔵のターミナルで gh auth login --web -h github.com を実行します。
3. GitHub に送る を押し、新しい Issue を作る か PR を選び、タイトル と 本文 を確かめます（直せます）。
4. 確認のチェックボックスに印を付け、Issue を作成 か コメントを投稿 を押します。

詳しくは次のとおりです。

• リポジトリは git remote get-url origin から決まります。
• Ferret は gh issue create --repo … --title … --body-file - か gh pr comment <n> --repo … --body-file - を実行します。
• 本文は、画像の行を除いた feedback.md で（画像はアップロードしません）、最大 60,000 文字です。
• PR の候補は、自分の開いている PR（最大30件）です。

GH_TOKEN か GITHUB_TOKEN が設定されていると、gh はそちらを優先して使い、設定画面に注意が出ます。

GitLab。 origin が GitLab のプロジェクト（gitlab.com またはセルフマネージドの GitLab）なら、同じボタンで GitLab CLI （新しいタブで開きます）（glab）を通して GitLab に送ります。新しい Issue か、自分の開いている Merge Request の1つへのコメントです。ログインは 設定 → GitHub / GitLab から行い、内蔵のターミナルで glab auth login（セルフマネージドの GitLab では --hostname 付き）を実行します。Ferret がトークンを読んだり保存したりすることはなく、GITLAB_TOKEN が設定されていると注意を出します。

star のお願い。 最初に Agentへ送信 した後と、終えたレビューが 3、10、30 件になったときに、Ferret が GitHub で star を付けてほしいと尋ねることがあります。尋ねるのは最大3回で、間は3日以上空け、録画中には尋ねません。GitHub で star は自分の gh のログインで star を付けます（gh が使えなければ GitHub を開きます）。今後表示しない を押すと、もう尋ねません。ヘルプ → GitHub で Ferret に star… からも star を付けられます。

#CLI ツールを入れてログインする

設定 → CLI には、エージェントがよく使うコマンドラインツールが並び、インストール済みかどうかとバージョンが出ます。OS に合った公式のインストールやログインのコマンドを、新しいターミナルのタブで実行できます。

• Git のホスティング: gh、glab
• AI とモデル: Ollama、Cloudflare wrangler
• デプロイ: Vercel、Netlify、Fly.io、Railway、Heroku
• クラウドとサービス: Supabase、Firebase、Stripe、Google Cloud（gcloud）、AWS、Azure、Docker

その OS 向けの1行の公式インストーラーが無いツールでは、ドキュメント がそのインストール方法のページを開きます。インストールが終わると、一覧は自動でもう一度確かめます。