Skip to content

Customization

Stefan Kuhn edited this page Jan 27, 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 ~/.aicage-custom

Then run any agent:

aicage codex

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), delete the project config file and run aicage again. Use aicage --config print to locate the file.

Choose a path

Clone this wiki locally