Skip to content

Customization

Stefan Kuhn edited this page Jul 15, 2026 · 6 revisions

Customization

aicage lets you customize images at three levels: extensions, agents, and base images. The sample repo is a fast way to see working examples and copy a template.

Quick start

git clone https://github.com/aicage/aicage-custom-samples.git $HOME/.aicage-custom

Then run any agent (replace <agent> with your agent):

aicage <agent>

These are only samples. Use them to learn the structure, then replace or edit them with your own definitions. aicage detects whatever you place under ~/.aicage-custom and offers it during selection.

After adding or changing custom definitions, restart aicage.

If your project is already configured for an agent, rerun aicage <agent> to review or change that saved config. Use aicage --config remove only to reset the whole project config, or aicage --config remove <agent> to reset one agent entry. Use aicage --config info to inspect the current config.

Choose a path

Clone this wiki locally