agenteye-cli）は、インストール可能な エージェントスキル です。Claude Code、Codex、および互換ツールなどのコーディングエージェントに、agenteye CLI を通じて自然言語のリクエスト（「今日、何か壊れているものはある？」、「イベントのプッシュのみ可能なキーを CI に発行して」、「発火中のインシデントを確認して自分にアサインして」）から AgentEye を操作する方法を教えます。
これはサービスでも独立したバイナリでもありません。すでにインストール済みの CLI の上で動作する、小さな命令バンドルです。エージェントは agenteye --json … をシェルアウトして実行し、返ってきたクリーンな JSON を解析して、結果を自然な文章で回答します。エージェントができることは、あなたが同じコマンドを手入力することで全て実現できます。
他の AgentEye インターフェースとの関係
AgentEye では、同じデータと操作にアクセスする方法が 4 つあります。それぞれ補完的な役割を持っています：| インターフェース | 概要 | 動作場所 | 使い所 |
|---|---|---|---|
| CLI | agenteye のコマンド・フラグリファレンス | ターミナル | 特定のコマンドを実行またはスクリプト化したいとき |
| CLI レシピ | コピー＆ペーストで使える jq・パイプラインパターン | ターミナル／スクリプト | CLI を自動化に組み込むとき |
| CLI スキル（このドキュメント） | CLI への自然言語フロントエンド | ワークステーション上のコーディングエージェント | 質問するだけでエージェントに適切なコマンドを選ばせたいとき |
| ダッシュボード内 AI アシスタント | ダッシュボードに組み込まれたチャット | クラスター内の内部 agent コンテナ | ダッシュボード上でデータに関する Q&A をしたいとき |
ダッシュボード内 AI アシスタントとの違い — 重要な区別
これらは影響範囲が大きく異なる、2 つの別々のツールです：- ダッシュボード内 AI アシスタント（assistant.md）は、内部
agentコンテナをバックエンドとして持つ、ダッシュボードに組み込まれたチャットです。読み取り専用＋承認ゲート付きの編集が可能で、保存済みクエリやダッシュボードの下書きを作成できますが、すべての書き込み操作はあなたの明示的なクリック承認が必要であり、削除操作は行いません。agent:use権限によってアクセスが制限され、閲覧中の組織のデータのみにアクセスできます。 - CLI スキルは あなたの ワークステーション上で あなたの コーディングエージェント内で動作し、あなた自身として
agenteyeCLI を操作します。API キーの作成・ローテーション・無効化、組織設定の変更、インシデントの解決、保存済みクエリの削除など、ミューテーションを含む CLI のフルサーフェスを実行できます。実行可能な操作はあなたの CLI ログインの権限にのみ制限されます。手動でコマンドを実行する場合と全く同じ慎重さで扱ってください。
前提条件
agenteyeCLI がインストール済みでPATHが通っていること（cli.md を参照 —pipx install agenteye）。- ダッシュボード URL が設定済みであること（
AGENTEYE_DASHBOARD_URL、またはエージェントが--base-urlを渡す）。 - ログイン済みのセッションがあること：事前に自分で
agenteye loginを実行してください。スキルはメールで送られるワンタイムコードによるログインを代行できません — セッションが存在しないか期限切れの場合（CLI 終了コード4）、agenteye loginを実行するよう案内します。
スキルのインストール
エージェントスキルはSKILL.md（とオプションの参照ファイル）を含むフォルダーです。agenteye-cli スキルは、エージェントがスキルを探す場所にフォルダーを配置することでインストールします：
- Claude Code —
agenteye-cli/フォルダーを~/.claude/skills/（全プロジェクトで利用可能）または<リポジトリ>/.claude/skills/（そのリポジトリに限定）にコピーします。Claude Code は自動的に検出します。/skillsリストで確認するか、説明に合致する質問を直接してみてください。 - Codex (OpenAI) — Codex は同じ
SKILL.mdを読み込みます。同梱のagents/openai.yamlはallow_implicit_invocation: trueを設定しているため、タスクが合致した場合は Codex が自動的にスキルを選択します。それ以外の場合は$agenteye-cliとして明示的に呼び出せます。
agenteye CLI と一緒にメンテナンスされ、AgentEye パッケージの一部として配布されています。agenteye-cli フォルダーが見当たらない場合は、AgentEye の担当者にお問い合わせください。Docker イメージも追加の認証情報も不要です。あなた自身のダッシュボードに対して 公開 の agenteye CLI を操作するだけです。
安全性 — エージェントが CLI を実行する際、ミューテーションは確認プロンプトを表示しません
エージェントに変更を加えさせる前に必ずお読みください。agenteye CLI は通常、破壊的な操作の前に 「本当によろしいですか？」 と確認を求めます。しかし、ターミナルに接続されていない場合は確認を自動スキップします — これはコーディングエージェントの実行方式そのものであり、--json も同様にスキップします。 そのため、エージェントに対して安全確認プロンプトは表示されません。
スキルはこれを補うように設計されています：実行するコマンドを明示的に提示し、状態変更の前にあなたの明示的な OK を求めるよう指示されています。この規律を守ってください — エージェントを通じて AgentEye を操作する際、あなた自身 が確認ステップです。注意すべき状態変更コマンドは以下の通りです：
keys create/update/disable/regenerateusers create/update/disable/enablesettings setalerts create/update/delete/test- 書き込み系
incidentsサブコマンド：ack/assign/resolve/open/comment-add/comment-delete/subscribe/unsubscribe query create/update/deleteagent rename/deleteorgs switch
events、sessions、evals、errors、list、whoami、orgs list/current/perms）はすべて読み取り専用で、何も変更しません。
エージェントは あなた自身 として動作するため、あなたのログインが許可している操作のみ実行できます。権限は組織ごとに解決されます（api-keys.md を参照）。権限がないコマンドは終了コード 5 と共に該当する権限名を返すため、エージェントは失敗の理由を不明瞭にせず、管理者に何を依頼すべきかを正確に伝えることができます。
質問できること
スキルは自然言語の意図を適切なagenteye コマンドにマッピングします。推測を避けるために、まず有効な値を確認します（list <kind>、whoami）：
- 「過去 24 時間に壊れている／失敗しているものはある？」 →
errors --since 24h --aggregateを実行し、内訳を表示。 - 「セッション
run-001はなぜ失敗した？」 →events --session-id run-001 --all+evals --session-id run-001。 - 「今週の品質トレンドはどう？」 →
evals --aggregate --since 7dを実行し、スコアの低いランについて詳細を確認。 - 「イベントのプッシュのみ可能なキーを CI に発行して。」 →
keys create ci --add events:add（コマンドを提示してから作成し、ワンタイムシークレットを取得）。 - 「誰がアクセスできる？Dana を読み取り専用にして。」 →
users list→users update dana@… --permission-set read-only（あなたに確認した後）。 - 「発火中のインシデントを確認して自分にアサインして。」 →
incidents list --state firing→incidents ack <id>/incidents assign <id> you@…。
関連ドキュメント
- CLI —
agenteyeのコマンドとフラグの完全なリファレンス。 - エージェント向け CLI レシピ — コピー＆ペーストで使える
jqパターンと終了コードの処理。 - AI アシスタント — ダッシュボード内アシスタント（このターミナルスキルとは異なります）。
- API キー — スキルの実行可能範囲を決める組織ごとの権限モデル。