Built-in tools in Gordon

Gordon includes an integrated toolbox that gives you access to system tools and capabilities. These tools extend Gordon's functionality so you can interact with the Docker Engine, Kubernetes, Docker Scout security scanning, and other developer utilities. This article describes the available tools, how to configure them, and usage patterns.

Configure tools

Configure tools globally in the toolbox to make them available throughout Gordon, including Docker Desktop and the CLI.

To configure tools:

  1. In the Ask Gordon view in Docker Desktop, select the Toolbox button at the bottom left of the input area.

    Screenshot showing Gordon page with the toolbox button.
  2. To enable or disable a tool, select it in the left menu and select the toggle.

    Screenshot showing Gordon's Toolbox.

    For more information about Docker tools, see Reference.

Usage examples

This section shows common tasks you can perform with Gordon tools.

Manage Docker containers

List and monitor containers

# List all running containers
$ docker ai "Show me all running containers"

# List containers using specific resources
$ docker ai "List all containers using more than 1GB of memory"

# View logs from a specific container
$ docker ai "Show me logs from my running api-container from the last hour"

Manage container lifecycle

# Run a new container
$ docker ai "Run a nginx container with port 80 exposed to localhost"

# Stop a specific container
$ docker ai "Stop my database container"

# Clean up unused containers
$ docker ai "Remove all stopped containers"

Work with Docker images

# List available images
$ docker ai "Show me all my local Docker images"

# Pull a specific image
$ docker ai "Pull the latest Ubuntu image"

# Build an image from a Dockerfile
$ docker ai "Build an image from my current directory and tag it as myapp:latest"

# Clean up unused images
$ docker ai "Remove all my unused images"

Manage Docker volumes

# List volumes
$ docker ai "List all my Docker volumes"

# Create a new volume
$ docker ai "Create a new volume called postgres-data"

# Back up data from a container to a volume
$ docker ai "Create a backup of my postgres container data to a new volume"

Perform Kubernetes operations

# Create a deployment
$ docker ai "Create an nginx deployment and make sure it's exposed locally"

# List resources
$ docker ai "Show me all deployments in the default namespace"

# Get logs
$ docker ai "Show me logs from the auth-service pod"

Run security analysis

# Scan for CVEs
$ docker ai "Scan my application for security vulnerabilities"

# Get security recommendations
$ docker ai "Give me recommendations for improving the security of my nodejs-app image"

Use development workflows

# Analyze and commit changes
$ docker ai "Look at my local changes, create multiple commits with sensible commit messages"

# Review branch status
$ docker ai "Show me the status of my current branch compared to main"

Reference

This section lists the built-in tools in Gordon's toolbox.

Docker tools

Interact with Docker containers, images, and volumes.

Container management

NameDescription
dockerAccess the Docker CLI
list_buildsList builds in the Docker daemon
build_logsShow build logs

Volume management

ToolDescription
list_volumesList all Docker volumes
remove_volumeRemove a Docker volume
create_volumeCreate a new Docker volume

Image management

ToolDescription
list_imagesList all Docker images
remove_imagesRemove Docker images
pull_imagePull an image from a registry
push_imagePush an image to a registry
build_imageBuild a Docker image
tag_imageTag a Docker image
inspectInspect a Docker object

Kubernetes tools

Interact with your Kubernetes cluster.

Pod management

ToolDescription
list_podsList all pods in the cluster
get_pod_logsGet logs from a specific pod

Deployment management

ToolDescription
list_deploymentsList all deployments
create_deploymentCreate a new deployment
expose_deploymentExpose a deployment as a service
remove_deploymentRemove a deployment

Service management

ToolDescription
list_servicesList all services
remove_serviceRemove a service

Cluster information

ToolDescription
list_namespacesList all namespaces
list_nodesList all nodes in the cluster

Docker Scout tools

Security analysis powered by Docker Scout.

ToolDescription
search_for_cvesAnalyze a Docker image, project directory, or other artifacts for vulnerabilities using Docker Scout CVEs.
get_security_recommendationsAnalyze a Docker image, project directory, or other artifacts for base image update recommendations using Docker Scout.

Developer tools

General-purpose development utilities.

ToolDescription
fetchRetrieve content from a URL
get_command_helpGet help for CLI commands
run_commandExecute shell commands
filesystemPerform filesystem operations
gitExecute git commands

AI model tools

ToolDescription
list_modelsList all available Docker models
pull_modelDownload a Docker model
run_modelQuery a model with a prompt
remove_modelRemove a Docker model

Docker MCP catalog

If you enable the MCP Toolkit feature, all the tools you enable and configure are available for Gordon to use.

|----------------|----------------------------------| | list_models | List all available Docker models | | pull_model | Download an Docker model | | run_model | Query a model with a prompt | | remove_model | Remove an Docker model |

Docker MCP Catalog

If you have enabled the MCP Toolkit feature, all the tools you have enabled and configured are available for Gordon to use.