# Gordon




Gordon is an AI-powered assistant 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.
> Business subscribers must complete two steps before users can access Gordon:
>
> 1. Contact Docker Support to activate Gordon for your organization. Docker
>    will confirm when activation is complete.
> 2. Once confirmed, an organization administrator must set **Enable Gordon** to
>    **Enabled** or **Always enabled** in the
>    [Admin Console](/enterprise/security/hardened-desktop/settings-management/configure-admin-console/).
>    Do not leave the setting at its default value, as this will not activate
>    Gordon organization-wide.

### Quick start

**Docker Desktop**



1. Open Docker Desktop.
2. Select **Gordon** in the sidebar.
3. Select your project directory.
4. Type a question: "What containers are running?"

   ![Gordon running in Docker Desktop](/ai/images/gordon_gui.avif)

5. Review Gordon's proposed actions and approve.

**CLI**



1. Open your terminal and run:

   ```console
   $ docker ai
   ```

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

2. Type a question: "what containers are running?" and press <kbd>Enter</kbd>.

   ![Gordon running in the terminal](/ai/images/gordon_tui.avif?border=true)

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](/ai/images/permissions.avif)

Permissions reset for each session. To configure default permissions or enable
auto-approve mode, see [Permissions](/ai/how-to/permissions/).

### Try these examples

Container inspection:

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

Dockerfile review:

```console
$ docker ai "review my Dockerfile for best practices"
```

Image management:

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