Agentty/ドキュメント

プラグイン

プラグインが Agentty に何を足すのか、マーケットプレイスや自分のフォルダからの入れ方、そして信用する前に確かめること。

プラグインは Agentty を他のアプリとつなぎ、ターミナルに道具を加えます。ターミナルの横にパネルを置き、エージェントペインの上にボタンを追加し、コマンドパレットに項目を入れ、テキストをプロンプトとしてエージェントに渡せます。そのプロンプトの行き先は、プラグインが尋ねてこない限りプラグインが決めます。ですからカードの権限は読む価値があります。

プラグインは Agentty が目指す方向でもあります。FDE(前線配置エンジニア)が自分の働く現場に合わせて作るように、プラグインでチーム・顧客・状況ごとに合ったエージェントを作り、1 つの Agentty でそのすべてを一貫して動かします。はじめにを参照してください。

自分で作るならプラグイン クイックスタートから始めてください。

エージェントは多様に、環境はひとつに:FDE という方向#

FDE(Forward Deployed Engineer、前方展開エンジニア)は、仕事のある現場——顧客のシステム、アカウント、仕事の進め方——に入り込み、そこに合ったエージェントを作ります。Agentty が広げていく方向はここにあります。プラグインで環境ごと・状況ごとに合ったエージェントを作り、それを動かす環境は Agentty ひとつに統合します。 どれだけ多様なエージェントを作っても、すべてがひとつの一貫した環境の中で構築され、動きます。

プラグインでエージェントを合わせる現場ごと、チームごと、状況ごとに専用のエージェントを置きます。仕事とパネル、作業してよいサイト、各ステップを任せるエージェントとモデルまでがプラグインに収まります(AgentOS プラグイン)。
実行は Agentty ひとつでどのエージェントも同じターミナルで、同じステータス表示、同じ権限、同じ 送信先… の承認で動きます。顧客ごとに実行環境を組み直すことはありません。
次の現場へそのままある環境でうまくいったエージェントは、プラグインのまま次の環境へ持ち込み、フォルダや Git からインストールして、一から作り直すのではなくその場に合わせて手直しします。

プラグインページ#

アクティビティバーのパズルアイコン、表示 → プラグイン、またはコマンドパレット(⇧⌘P →「プラグイン」)で開きます。

  • インストール済み — 手元のすべてのプラグインと、何を加え何ができるか。
  • マーケットプレイス — Agentty が提供するプラグインの一覧。自身のプラグインも含みます。下を参照してください。
  • 利用可能 — Agentty に同梱されているプラグイン。連携先のアプリが入っていればおすすめと表示されます。
  • 自分で作る — AI でプラグインを作る、または Git リポジトリやフォルダから導入する。

インストール済みの各プラグインには、有効化 / 無効化、パネルを開く、再起動(コード変更後)、更新(内蔵版の新しいバージョンが出たとき)、ログ(出力内容とクラッシュ)、Finder で表示、削除(2 回押して確認)があります。

プラグインは Agentty の起動時ではなく最初に使われたときに開始するので、使っていないプラグインの負荷はゼロです。

導入方法#

入手元方法
マーケットプレイスマーケットプレイス のカードのインストール
内蔵利用可能 のカードのインストール
Git リポジトリ自分で作る の欄に https:// の URL を貼り Git からインストール
フォルダフォルダからインストール… が ~/.agentty/plugins/ へコピーします
編集中のフォルダ開発用にフォルダをリンク… はその場で実行します。削除してもリンクが外れるだけです

プラグインのフォルダを自分で ~/.agentty/plugins/ に置き、再読み込みを押しても構いません。

何を信用することになるか#

インストール前に、カードの権限の下にそのプラグインにできることが完全な文で示されます。HTTP リクエストを送る、エージェントセッションを始める、ターミナルに入力する、AI 会話を読む、ワークスペースを見る。

情報 → 実行方式には、そのプラグインがまったく異なる 2 つのどちらであるかが示されます。

WebAssemblyAgentty がモジュールを自分で実行します。自分のファイルもプロセスもネットワークも持たず、どう書かれていてもその権限が許したものにしか触れません。
プログラム(node, python, 実行ファイル)利用者の権限で動き、利用者が起動する他のものと同じアクセス権を持ちます。権限は Agentty 越しの動作を制限しますが、プログラム自体は何も制限されません。
Important

プログラム型のプラグインは作者を信頼できるときだけ入れてください。マーケットプレイスにあるものはすべて前者で、一覧からバイナリを入れても大丈夫な理由がそれです。

仕組みの全体はプラグインの権限にあります。

マーケットプレイス#

プラグイン → マーケットプレイスは Agentty-Marketplace が提供する一覧を表示します。プラグインはプルリクエストで追加され、載るのはソースが公開された WebAssembly モジュールだけです。Agentty 自身のプラグインも同じ条件でそこにあります。アプリケーションに同梱されているものはありません。

インストールするとこうなります。

  1. Agentty が HTTPS で一覧を読み、すべての項目をここで検査し直します。id、文言、権限、モジュールの配信元ホストまで。通らなかった項目は表示される代わりに一覧から外れます。
  2. カードが、それが何か、ソースはどこか、ライセンス、モジュールのサイズとチェックサム、そして何ができるかを示します。
  3. インストールを押すと、Agentty はモジュールをダウンロードしてそのチェックサムと照合します。一致するまでプラグインフォルダには何も入りません。

項目には、そのモジュールがどのプラグインプロトコルを対象にしたかも書かれています。古いバージョンしか話せない Agentty は、プラグインを一覧には出しつつ、インストールを勧める代わりに新しい Agentty が必要だと伝えます。

自分だけで使うプラグインはその一覧を通る必要がありません。フォルダからインストール… と Git からインストールは何でも受け取ります。

使い方#

  • パネル — パネルを持つプラグインはボタンが現れます。ターミナル上のタブ列、左端のアクティビティバー、下部のステータスバーのうち、プラグインが選んだ場所です。クリックで開き、もう一度で閉じます。パネルヘッダーの ↻ はプラグインを再起動し、歯車はプラグインページを開きます。
  • コマンドパレット — ⇧⌘P のプラグインの項にすべてのプラグインコマンドが並びます。

パネルが開く場所#

パネルのレイアウトボタンで開き方を変えられ、その選択は保たれます。

ドッキングターミナルの横に付き、ターミナルが場所を空けます
浮かぶ窓の右端に浮かび、他は動きません
独立した窓別の窓。移動とサイズ変更ができます
全体ターミナルとページが使う領域の全体

ドッキングしたパネルが残りの窓を押しつぶすほど大きくなることはありません。ドッキングできる幅を越えて引くと、浮かぶパネルになります。

「送信先…」ダイアログ#

プラグインや他のアプリからのリンクがプロンプトを送るとき、Agentty は何が送られるかを示して選ばせます。

  • Claude Code / Codex / ターミナル
  • 新しいワークスペース(フォルダは変更可)、現在のワークスペースの新しいタブ、または開いているワークスペースのいずれか — そこに待機中のエージェントがいれば受け取り、いなければ新しいエージェントタブが開きます
  • すぐ送信するか、チェックを外して入力だけ行い Enter を押さないようにできます

ターミナルには入力されるだけで、この経路で送られたプロンプトに Enter が押されることはありません。送信を押すまで何も送られません。

terminal.write は別物です。この権限を持つプラグインは開いているターミナルに入力し、Enter まで押します。シェルならそのコマンドが実行されます。その手前にダイアログはなく、カードがこの権限を別に名指しするのはそのためです。

他のアプリからのリンク#

他のアプリは agentty:// リンクで Agentty に作業を渡せます。Cosmica の「Agentty で続ける」がその例です。

リンク動作
agentty://plugin/<id>/<path>?key=valueプラグイン <id> を起動し URL ハンドラを呼びます
agentty://prompt?text=…&title=…&agent=…&cwd=…そのテキストで**送信先…**を開きます(file= で絶対パスの .md・.txt を添付)
agentty://plugins/<id>プラグインページの該当プラグインを開きます

リンクが必要とする内蔵プラグインがまだなければ、Agentty が導入を提案し、そのままリンクの処理を続けます。この経路で届いたプロンプトは必ず**送信先…**を通ります。

Note

リンクはインストール済みのアプリケーションで動作します。開発用に起動したビルドは、OS に agentty:// のハンドラとして登録されません。

Cosmica#

Cosmica はノートアプリです。プラグインは Agentty に同梱され、Cosmica がインストールされていればおすすめと表示されます。Cosmica の設定からノートフォルダとローカルポートだけを読みます。

  1. Cosmica のカードでプラグイン → インストールを押し、タブ領域からパネルを開きます。
  2. このセッションを保存(パネルの一番上)— Claude Code か Codex のペインがフォーカスされた状態でCosmica に保存を押すと、エージェントが目的・実施内容・変更ファイル・決定事項・次の手順をまとめた要約を、その下で選んだフォルダに書きます。フォルダは Cosmica のノートから読み込まれ、既定では Agentty が選ばれて最初の保存時に作られます。+ 新しいフォルダで別のフォルダを作れます。会話ログのみは AI に尋ねずに元の会話を保存します。
  3. ノートから続ける — ノートをクリックすると新しいタブで続きを作業します。Agentty が保存した要約は、書かれたときのフォルダとエージェントで開き直し、それ以外はフォーカス中のペインのフォルダとエージェントを使います。最近のノートが数件だけ先に表示され(残りはもっと見る)、検索はすべてのノートが対象です。行のボタンでフォーカス中のターミナルに挿入するか、**別の場所で続ける…**で場所を選べます。
  4. Cosmica から — ノートを右クリック →Agentty で続ける。ノートが入力された状態で新しいタブが開きます。読んでから Enter で開始します。

まだ作業中のエージェントには依頼が順番待ちで入り、ターンが終わり次第要約を書きます。回答や承認を待っているエージェントには触れません。Cosmica が起動していればローカル API 経由で保存されすぐ索引されます。そうでなければファイルとして書かれ、次回の起動時に取り込まれます。

うまくいかないとき#

症状対処
「Node.js が見つかりません」JavaScript のプラグインにはログインシェルの PATH に Node.js 18 以降が必要です。WebAssembly プラグインには何も要りません
マーケットプレイスからのインストールが拒否されたモジュールが一覧のチェックサムと一致しませんでした。何も書き込まれていません。プラグインの作者に知らせてください
カードに新しい Agentty が必要と出るこのバージョンが知らないプラグインプロトコルで作られています。Agentty を更新してください
カードにエラーで停止したと出るカードのログを開き、コードを直してから再起動
コピーしたプラグインが出てこない再読み込みを押し、フォルダ名が agentty-plugin.json の id と一致しているか確認
リンクを開いても何も起きないインストール済みのアプリケーションを使い、リンクが指すプラグインが導入され有効になっているか確認
更新後に挙動がおかしい再起動するか無効化し、作者に問題を伝えてください

ファイルの場所#

パス用途
~/.agentty/plugins/<id>/プラグイン本体
~/.agentty/plugins/state.json有効状態と開発用リンクの参照先
~/.agentty/plugin-data/<id>/プラグインの設定とキャッシュ
~/.agentty/plugins/.sdk/開発者ガイドが展開する SDK と資料
~/.agentty/prompts/ファイルとして渡される長いプロンプト

削除するとプラグインは取り除かれますが、データフォルダは自分で消すまで残ります。

次に読むもの#