> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Integrations

> Teach AI coding agents to write and migrate Dockerfiles using hardened Minimus images

AI coding agents increasingly write and maintain Dockerfiles - but left to their training data, they default to bloated, general-purpose base images with large, ever-growing CVE counts. Minimus AI Integrations close that gap, teaching any AI agent to build and migrate Dockerfiles using hardened Minimus distroless images instead.

<iframe src="https://www.youtube.com/embed/fysFRqs5IrA" title="Minimus AI Migration Assistant for Faster Hardened Image Adoption (YouTube video)" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen>
  Your browser does not support embedded videos. You can [watch this video on YouTube](https://www.youtube.com/watch?v=fysFRqs5IrA) instead.
</iframe>

## What it does

At its core, Minimus AI Integrations is a Dockerfile migration prompt - instructions that teach an AI agent to reach for Minimus images whenever it's asked to create, migrate, convert, or harden a Dockerfile or Containerfile, swap in a secure or distroless base image, or reduce a container's CVE count.

Rather than guessing at a base image and package list, the agent follows a consistent workflow: discover the relevant Minimus image, select the right tag, inspect runtime requirements, resolve dependencies, compose the Dockerfile, then verify the result and its security posture. This turns Dockerfile hardening from a manual, expert-only task into something any AI agent can do reliably.

Because Minimus images follow the [dev and production two-variant model](/introduction/dev-images), agents are guided to use the fully distroless production variant for the final runtime stage while still relying on the dev variant - which includes a shell and package manager - for the build stage. The result is a multi-stage Dockerfile that builds normally but ships with none of the extra tooling that expands the attack surface.

## Ways to integrate

Minimus AI Integrations can be adopted at whatever scope fits how you work. The one-off prompt is available to everyone, including Community Edition users; installing the integration per repo or globally requires an Enterprise Edition account.

### Community Edition

<Columns cols={2}>
  <Column>
    <Card title="One-off prompt" icon="comment-code">
      Paste the migration prompt directly into a chat with your AI agent to migrate a single Dockerfile or scaffold a new containerized app on the spot. No setup or account required.
    </Card>
  </Column>
</Columns>

### Enterprise Edition

<Columns cols={3}>
  <Column>
    <Card title="Per repo AI integration" icon="folder-gear">
      Add the integration to a single repository so every agent working in that codebase automatically follows Minimus conventions for that project.
    </Card>
  </Column>

  <Column>
    <Card title="Global AI integration" icon="globe">
      Configure the integration once across your organization so all AI agents, on any repository, default to Minimus images and hardening practices.
    </Card>
  </Column>

  <Column>
    <Card title="Generate skills for minicli" icon="rectangle-terminal" href="/enterprise-edition/minicli#2-generate-skills">
      Equip agents to create, configure, and inspect your private Minimus images using natural language prompts.
    </Card>
  </Column>
</Columns>

## Built for agents, not just humans

Minimus AI Integrations are designed around how agents actually work: image discovery does not require authentication, so agents can look up Minimus images and tags without any setup friction. The full Minimus documentation is also indexed for LLMs, giving agents a reliable, up-to-date reference to reason over instead of relying on outdated training data about container best practices.

## Supported agents

The following agents are natively supported:

* Claude Code
* Cursor
* OpenAI Codex
* GitHub Copilot (minicli only)
* Windsurf (minicli only)

## Get started

Visit the [Minimus AI Integrations page](https://images.minimus.io/ai-integrations) to copy the migration prompt for a quick one-off conversation, or set up a per-repository or global integration with an Enterprise Edition account.


## Related topics

- [What's New](/release-notes.md)
- [What's New 2025](/release-notes-2025.md)
- [Minimus Enterprise Edition](/introduction/enterprise-edition.md)