エージェント界の
SSH。
agent-exec は AI エージェントに、自己記述型・ACL制御付きのマシン操作入口を与えます。 URL と API キーを渡すと、エージェントは/SKILL.mdを読み、/api/aclで許可範囲を確認し、/api/execで許可されたコマンドだけを実行します。
aexec --versionだけです。 localhost、VPN、firewall、TLS termination された trusted network で使ってください。インストール、起動、共有。あとは貼るだけ。
aexecが正式コマンドです。aeは普段使いの短縮エイリアスです。
# 1. インストール $ npm install -g @to-agent/agent-exec # 2. ローカル設定と API キーを作成 $ aexec setup # 3. サーバー起動 $ aexec start # 4. AI エージェントに貼るプロンプトを生成 $ aexec share # 任意: インストール済み AI ツールを plugin として公開 $ aexec starterkit $ aexec restart
Install agent-exec on this machine. Run: 1. Check that Node.js and npm are available. 2. Install globally: npm install -g @to-agent/agent-exec 3. Run: aexec setup 4. Start the server: aexec start 5. Run: aexec share 6. Show me the generated share prompt. Do not edit project files unless needed. Do not expose agent-exec to the public internet. Do not use --public unless I explicitly ask for network access. Do not add broad ACL rules such as allow "*". Fresh installs should only allow: aexec --version If any command fails, stop and show me the error plus the next recommended command.
agent-exec を通じてマシンにアクセスできます。 URL: http://<agent-exec-host>:3333 API_KEY: <api-key> ここから始めてください: http://<agent-exec-host>:3333/SKILL.md
エージェントに、自分を説明できるマシン。
agent-exec は専用 SDK やモデル別の統合を要求しません。 マシンが小さな HTTP 入口を公開し、エージェントがドキュメントに従って操作します。
/SKILL.md を読む
公開入口です。エージェントに、まず何を読めばよいかを伝えます。
/api/acl を確認
実行前に、許可されたコマンド範囲を確認します。
/api/plugins を発見
必要なときだけ、plugin の追加ドキュメントを読みます。
POST /api/exec
サーバーは ACL が許可した操作だけを実行します。
plugin と skill で拡張できます。
plugin はツールごとのドキュメントと任意のコマンド挙動を追加します。 skill は詳細を初期プロンプトから分離し、必要になった時だけエージェントに読ませます。
$ aexec plugin list $ aexec plugin create --name=mytool --command=mytool $ aexec plugin doctor
shell string ではなく argv。
/api/execは JSON body の args だけを受け付けます。 GET request と query-string command は実行されません。
JSON body only
コマンドは{"args":["command","arg"]}として送ります。?cmd=や?args=は実行入力ではありません。
No shell interpretation
agent-exec は argv を実行します。&&、;、pipe、redirect、subshell syntax は agent-exec 自体では解釈されません。
Deny before allow
ACL matching はargs.join(' ')を使います。plain string は完全一致のみです。広い matching は glob / regex rule で明示します。cmd *のような rule はcmdへの任意 args を許可します。deny rule は allow rule より優先されます。
Trusted plugins are host code
trusted plugin は agent-exec の OS user として実行されるコードとして review してください。未レビューの trusted plugin を入れないでください。
エージェントは発見する。判断はサーバーが強制する。
agent-exec は default-deny です。fresh install ではaexec --versionだけを許可します。 ACL、最小権限の OS ユーザー、ネットワーク制御を併用してください。 これは AI エージェント向けの SSH-like access であり、SSH互換でも SSH の置き換えでもありません。