arctl wrap-agent-image

Wrap an agent image with the agent-proxy layer

Wrap a user’s agent container image with the agent-proxy layer and rewrite its entrypoint to launch the agent through agent-proxy, producing a new image to push to any registry.

By default it writes a docker-loadable tar (then: docker load + docker push); –push uploads straight to –tag.

Usage

arctl wrap-agent-image [flags]

Example:

# Released CLIs download and cache their version-matched layer automatically
arctl wrap-agent-image --image repo/agent:tag \
  --tag <acct>.dkr.ecr.<region>.amazonaws.com/agent:wrapped

# Source builds use an explicit matching local layer
arctl wrap-agent-image --image repo/agent:tag --proxy-layer dist/agent-proxy-layer-arm64.tar \
  --tag <acct>.dkr.ecr.<region>.amazonaws.com/agent:wrapped --push

Command-specific flags

--image string: user agent image reference to wrap (required).
-o, --output string: docker-loadable tar to write; defaults to <tmpdir>/<image-name>-wrapped.tar (ignored with --push).
--platform string: base image platform to wrap (linux/arm64 for AgentCore, linux/amd64 for others) (default "linux/arm64").
--proxy-layer string: local path or HTTP(S) URL for the proxy layer tar; defaults to the version-matched layer when available.
--push: push directly to --tag instead of writing a tar.
-t, --tag string: reference to assign the wrapped image, e.g. <acct>.dkr.ecr.<region>.amazonaws.com/agent:wrapped (required).

Global flags

-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 wait