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/          # optional
   ├─ 01-setup.sh
   └─ 02-install.sh

Define at least one of scripts/ or shares.

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

extension.yml

name: "Display name"
description: "Short description of what the extension adds."
shares: # optional
  - ~/.config/my-tool
  - ~/.cache/my-tool:ro

shares can be used to define host mounts. Each entry uses the same syntax as --share: HOST or HOST:ro.

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