Skip to content

Customization

Stefan Kuhn edited this page Feb 26, 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, aicage will keep using the saved config. To reconfigure (and see new bases/agents/extensions), run aicage --config remove and start aicage again. To reset only one agent entry, use aicage --config remove <agent>. Use aicage --config info to inspect the current config.

Choose a path

Clone this wiki locally