Share feedback
Answers are generated based on the documentation.

Gordon

Table of contents
Availability: Beta
Requires: Docker Desktop 4.61.0 or later

Gordon is an AI agent that takes action on your Docker workflows. It analyzes your environment, proposes solutions, and executes commands with your permission. Available in Docker Desktop and via the docker ai CLI command.

What Gordon does

Gordon takes action to help you with Docker tasks:

  • Explains Docker concepts and commands
  • Searches Docker documentation and web resources for solutions
  • Writes and modifies Dockerfiles following best practices
  • Debugs container failures by reading logs and proposing fixes
  • Manages containers, images, volumes, and networks

Gordon proposes every action before executing. You approve what it does.

Get started

Prerequisites

Before you begin:

  • Docker Desktop 4.61.0 or later
  • Sign in to your Docker account
Note

Gordon is enabled by default for Personal, Pro, and Team subscriptions. For Business subscriptions, an administrator must enable Gordon for the organization before users can access it.

Quick start

  1. Open Docker Desktop.

  2. Select Ask Gordon in the sidebar.

  3. Select your project directory.

  4. Type a question: "What containers are running?"

    Gordon running in Docker Desktop

  5. Review Gordon's proposed actions and approve.

  1. Open your terminal and run:

    $ docker ai

    This opens the Terminal User Interface (TUI) for Gordon.

  2. Type a question: "what containers are running?" and press Enter.

    Gordon running in the terminal

  3. Review Gordon's proposed actions and approve by typing y.

Permissions

By default, Gordon asks for approval before executing actions. You can approve individual actions or allow all actions for the current session.

Gordon permission request

Permissions reset for each session. To configure default permissions or enable auto-approve mode, see Permissions.

Try these examples

Container inspection:

$ docker ai "show me logs from my nginx container"

Dockerfile review:

$ docker ai "review my Dockerfile for best practices"

Image management:

$ docker ai "list my local images and their sizes"

Usage and availability

Gordon is available with all Docker subscriptions. Usage limits vary by tier:

  • Personal: Baseline usage
  • Pro and Team: 3x more usage than Personal
  • Business: 6x more usage than Personal

For details, see Usage and limits.