CLI

arctl コマンドラインインターフェイスのリファレンスドキュメント。

arctl コマンドラインインターフェイス (CLI) は、AgentRegistry でエージェント、MCP サーバー、スキル、プロンプトを管理するための主要なツールです。

インストール

GitHub のリリースページから arctl CLI をダウンロードしてインストールします。

curl -sSL https://storage.googleapis.com/agentregistry-enterprise/install.sh | ARCTL_VERSION=v2026.9.0 sh
export PATH=$HOME/.arctl/bin:$PATH

CLI をインストールした後、コマンドを実行する前に OIDC プロバイダーに対して CLI を認証する必要があります。ログインを含む完全なセットアップについては、Get startedガイドを参照してください。

はじめに

# Scaffold a new agent project
arctl init agent my-agent

# Run the agent locally
arctl run ./my-agent

# Apply resources to the registry
arctl apply -f my-agent/agent.yaml

# List all agents
arctl get agents

環境変数

次の環境変数を使用して arctl を構成できます。

変数	説明
`ARCTL_API_TOKEN`	認証用のレジストリベアラートークン
`ARCTL_API_BASE_URL`	レジストリのベース URL (既定: http://localhost:12121)

グローバルフラグ

すべてのコマンドは次のグローバルフラグをサポートします。

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

コマンド

CLI をインストールする: arctl コマンドラインインターフェイスのインストール手順の場所。
arctl: arctl は、エージェント、MCP サーバー、スキル、プロンプトを管理するための CLI ツールです。
arctl apply: YAML ファイルから 1 つ以上のレジストリリソースを適用します
arctl bug-report: レジストリリソースとインストールログを収集します
arctl build: 宣言型リソースプロジェクト用の Docker イメージをビルドします
arctl completion: 指定したシェル用の自動補完スクリプトを生成します
arctl completion bash: bash 用の自動補完スクリプトを生成します
arctl completion fish: fish 用の自動補完スクリプトを生成します
arctl completion powershell: powershell 用の自動補完スクリプトを生成します
arctl completion zsh: zsh 用の自動補完スクリプトを生成します
arctl configure: クライアントが arctl に接続するために必要な JSON 設定を書き込みます
arctl configure claude-code: Claude Code を設定します
arctl configure cursor: Cursor AI Editor を設定します
arctl configure kiro: Kiro agentic IDE を設定します
arctl configure vscode: Visual Studio Code を設定します
arctl db: データベース操作 (移行、検査)
arctl db migrate: データベース移行を適用、ロールバック、検査します
arctl db migrate down: 選択したソースに対して、最近適用された N 件の移行をロールバックします
arctl db migrate force: SQL を実行せずにバージョン V を適用済みとしてマークします
arctl db migrate status: すべてのソースで適用済みと保留中の移行数を表示します
arctl db migrate up: 登録済みのすべてのソースに対して、保留中の移行をすべて適用します
arctl db migrate version: 適用済みの最上位移行バージョンを出力します
arctl delete: レジストリリソースをタイプと名前で、またはファイルから削除します
arctl get: レジストリリソースをタイプ別に一覧表示または取得します
arctl init: 宣言型のエージェント、MCP、スキル、またはプロンプトプロジェクトをスキャフォールドします
arctl init agent: YAML とフレームワークスタブを含むエージェントプロジェクトをスキャフォールドします
arctl init mcp: YAML とフレームワークスタブを含む MCP サーバープロジェクトをスキャフォールドします
arctl init prompt: 宣言型プロンプト YAML (ar.dev/v1alpha1) を作成します
arctl init skill: YAML とソーススタブを含むスキルプロジェクトをスキャフォールドします
arctl pull: レジストリリソースのソースリポジトリをローカルディレクトリに取得します
arctl run: 現在のプロジェクトディレクトリでエージェントまたは MCP サーバーを実行します
arctl runtime: ランタイムブートストラップヘルパー
arctl runtime setup: ランタイムブートストラップ設定を生成します
arctl runtime setup bedrock-agent-core: BedrockAgentCore ランタイム用の AWS ブートストラップアーティファクトを生成します
arctl user: ユーザー管理
arctl user info: 保存済みトークンからユーザー情報を出力します
arctl user login: agentregistry にログインします
arctl user logout: エンタープライズ CLI からログアウトします
arctl user whoami: 現在のユーザー ID とロールを表示します
arctl version: arctl CLI とレジストリサーバーのバージョンを表示します
arctl wait: レジストリリソースがターゲット状態に到達するまで待機します
arctl wrap-agent-image: エージェントイメージを agent-proxy レイヤーでラップします

CLI のインストール

arctl コマンドラインインターフェイスのインストール手順の場所。

arctl

arctl は、エージェント、MCP サーバー、スキル、プロンプトを管理するための CLI ツールです。

arctl apply

YAML ファイルから 1 つ以上のレジストリリソースを適用します。

arctl bug-report

レジストリリソースとインストールログを収集します

arctl build

宣言型リソースプロジェクト用の Docker イメージをビルドします

arctl completion

指定したシェル用の自動補完スクリプトを生成します

arctl completion bash

bash 用の自動補完スクリプトを生成します

arctl completion fish

fish 用の自動補完スクリプトを生成します

arctl completion powershell

powershell 用の自動補完スクリプトを生成します

arctl completion zsh

zsh 用の自動補完スクリプトを生成します

arctl configure

クライアントが arctl に接続するために必要な JSON 設定を書き込みます。

arctl configure claude-code

Claude Code を設定します

arctl configure cursor

Cursor AI Editor を設定します

arctl configure kiro

Kiro agentic IDE を設定します

arctl configure vscode

Visual Studio Code を設定します

arctl db

データベース操作 (移行、検査)

arctl db migrate

データベース移行を適用、ロールバック、検査します

arctl db migrate down

選択したソースに対して、最近適用された N 件の移行をロールバックします

arctl db migrate force

SQL を実行せずにバージョン V を適用済みとしてマークします

arctl db migrate status

すべてのソースで適用済みと保留中の移行数を表示します

arctl db migrate up

登録済みのすべてのソースに対して、保留中の移行をすべて適用します

arctl db migrate version

適用済みの最上位移行バージョンを出力します

arctl delete

レジストリリソースをタイプと名前で、またはファイルから削除します。

arctl get

レジストリリソースをタイプ別に一覧表示または取得します。

arctl init

宣言型 YAML を含む新しいリソースプロジェクトをスキャフォールドします

arctl init agent

新しいエージェントプロジェクトをスキャフォールドします

arctl init mcp

新しい MCP サーバープロジェクトをスキャフォールドします

arctl init prompt

プロンプト用の新しい宣言型 <name>.yaml を作成します

arctl init skill

宣言型 skill.yaml を含む新しいスキルプロジェクトをスキャフォールドします

arctl pull

レジストリリソースのソースリポジトリをローカルに取得します

arctl run

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

arctl runtime

ランタイムブートストラップヘルパー

arctl runtime setup

ランタイムブートストラップ設定を生成します

arctl runtime setup bedrock-agent-core

BedrockAgentCore ランタイム用の AWS ブートストラップアーティファクトを生成します

arctl user

ユーザー管理

arctl user info

保存済みトークンからユーザー情報を出力します

arctl user login

agentregistry にログインします

arctl user logout

エンタープライズ CLI からログアウトします

arctl user whoami

現在のユーザー ID とロールを表示します

arctl version

arctl CLI とレジストリサーバーのバージョンを表示します

arctl wait

レジストリリソースが目標状態に到達するまで待機します

arctl wrap-agent-image

エージェントイメージを agent-proxy レイヤーでラップします

API Helm