Customization Extensions

Extensions

Extensions add extra tools on top of an existing agent image. They are defined locally under ~/.aicage-custom/extensions/ and are applied in the order you select them.

Directory layout

~/.aicage-custom/extensions/<EXTENSION>/
├─ extension.yml (or extension.yaml)
├─ Dockerfile        # optional
└─ scripts/
   ├─ 01-setup.sh
   └─ 02-install.sh

Only scripts in scripts/ are executed, in alphabetical order.

extension.yml

name: "Display name"
description: "Short description of what the extension adds."

Scripts

Scripts run inside the image build. Use bash, keep them non-interactive, and fail fast on errors.

Dockerfile (optional)

If present, your Dockerfile replaces the built-in extension Dockerfile. The build args provided are BASE_IMAGE and EXTENSION.

Examples

• Act sample
• Marker sample