For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
arctl init agent
新しいエージェントプロジェクトをスキャフォールドします
宣言型 YAML とフレームワークスタブを備えた新しいエージェントプロジェクトのスキャフォールドを作成します。
フレームワーク + 言語をインタラクティブに選択します (-framework / -language で指定することもできます)。次のファイルを書き込みます。
- agent.yaml – v1alpha1 エンベロープ
- arctl.yaml – ローカルビルド設定 (フレームワーク + 言語)
- .env – 選択したフレームワークに必要な環境変数 (gitignore 対象)
ローカル開発用に arctl-init で作成した同階層の MCP プロジェクトを接続するには、-local-mcp を渡します。任意の URL にある MCP (リモート、または arctl で初期化していないローカル MCP) を使用する場合は、init 後に .env を編集して MCP_SERVERS_CONFIG エントリを追加します。例:
MCP_SERVERS_CONFIG=[{“name”:“my-remote”,“type”:“remote”,“url”:“https://mcp.example.com/sse"}]
使用方法
arctl init agent NAME [flags]例:
arctl init agent myagent
arctl init agent myagent --framework adk --language python
arctl init agent myagent --local-mcp ../my-mcpコマンド固有のフラグ
--description string: Agent description.
--framework string: Framework (e.g. adk). Skips picker.
--git string: Git repository URL.
--git-branch string: Git branch to record on the agent's source repository.
--git-commit string: Git commit SHA to pin the agent's source repository to.
--image string: Image tag override.
--language string: Language (e.g. python). Skips picker.
--local-mcp strings: Path to a sibling MCP project; wires it into .env so the local agent can reach it. Repeatable.
--mcp strings: Registry MCP server ref (name@version). Repeatable.
--model-name string: Model name.
--model-provider string: Model provider.グローバルフラグ
-h, --help: Display help information for the command.
--output-dir string: Parent directory under which the project is created. Defaults to the current directory.