arctl run

現在のディレクトリでエージェントまたは MCP サーバーを実行します

プロジェクトディレクトリ内の宣言型 YAML で定義されたエージェントまたは MCP サーバーを実行します (デフォルトは “.")。

エージェントの場合、デフォルトの動作はバックグラウンドでランタイムを起動し、エージェントの HTTP エンドポイントに到達可能になるまで待機してから、インタラクティブな A2A チャットを起動します。チャットを終了するとランタイムは停止します。従来のフォアグラウンド専用の動作を維持するには --no-chat を使用します。

MCPServer タイプにはチャットは適用されません。フレームワークの実行コマンドが中断されるまでフォアグラウンドで実行されます。--inspector を渡すと、サーバーと並行して MCP Inspector サブプロセスが起動されます (PATH 上に npx が必要)。Inspector はサーバーに到達できるまでリトライします。

arctl.yaml を読み取り、(framework, language) の組み合わせに一致するフレームワークを検索し、実行コマンドに処理を委譲します。.env が存在する場合はロードし、フレームワークに必要な環境変数が設定されているか検証します。

使用方法

arctl run [DIRECTORY] [flags]

例:

arctl run
arctl run ./myagent
arctl run -e FOO=bar -e BAZ=qux
arctl run --no-chat              # agent without chat
arctl run --watch                # iterative dev loop
arctl run mymcp --inspector      # MCP with MCP Inspector launched

コマンド固有のフラグ

--dry-run: Skip actual exec; useful for tests.
-e, --env stringArray: KEY=VALUE env override.
--inspector: Launch MCP Inspector alongside the server; it connects when ready (MCP projects only; errors on agent projects).
--no-chat: Skip chat for Agents; run the framework command in the foreground (agent projects only; errors on MCP projects).
--watch: Rebuild and restart on file change (skips chat for agents; for chat open a second terminal).

グローバルフラグ

-h, --help: Display help information for the command.
--registry-token string: Registry bearer token (defaults to value of ARCTL_API_TOKEN env var).
--registry-url string: Registry URL (overrides ARCTL_API_BASE_URL env var; defaults to http://localhost:12121).

arctl pull arctl runtime