fix: rename cagent binary to docker-agent (#109)

Signed-off-by: Derek Misler <derek.misler@docker.com>

Author: derekmisler

.github/workflows/pr-describe.yml

@@ -195,11 +195,11 @@ jobs:
             const descriptionFile = '${{ steps.generate.outputs.output-file }}';
 
             try {
-              // Read generated description and extract cagent-output block if present.
+              // Read generated description and extract docker-agent-output block if present.
               // The composite action should already clean this, but the agent may
               // emit conversational text before the code fence that slips through.
               const raw = fs.readFileSync(descriptionFile, 'utf8');
-              const fenceMatch = raw.match(/```cagent-output[\s\S]*?\n([\s\S]*?)```/);
+              const fenceMatch = raw.match(/```docker-agent-output[\s\S]*?\n([\s\S]*?)```/);
               let description;
               if (fenceMatch) {
                 description = fenceMatch[1].trim();

.github/workflows/release.yml

@@ -122,8 +122,8 @@ jobs:
 
           # Create a detached commit (not on main) with the pinned refs
           # Note: write-tree captures the full index (all files from HEAD),
-          # but we explicitly add CAGENT_VERSION for clarity.
-          git add "${PINNED_FILES[@]}" CAGENT_VERSION
+          # but we explicitly add DOCKER_AGENT_VERSION for clarity.
+          git add "${PINNED_FILES[@]}" DOCKER_AGENT_VERSION
           TREE=$(git write-tree)
           RELEASE_SHA=$(git commit-tree "$TREE" -p HEAD -m "release: ${VERSION}")
 
@@ -276,19 +276,19 @@ jobs:
         with:
           ref: ${{ needs.release.outputs.version }}
 
-      - name: Install cagent
+      - name: Install Docker Agent
         run: |
           set -e
-          CAGENT_VERSION=$(tr -d '[:space:]' < CAGENT_VERSION)
-          if [ -z "$CAGENT_VERSION" ]; then
-            echo "::error::Could not extract cagent version from CAGENT_VERSION"
+          DOCKER_AGENT_VERSION=$(tr -d '[:space:]' < DOCKER_AGENT_VERSION)
+          if [ -z "$DOCKER_AGENT_VERSION" ]; then
+            echo "::error::Could not extract Docker Agent version from DOCKER_AGENT_VERSION"
             exit 1
           fi
-          echo "Using cagent version from CAGENT_VERSION: ${CAGENT_VERSION}"
-          curl -fL -o cagent \
-            "https://github.com/docker/docker-agent/releases/download/${CAGENT_VERSION}/cagent-linux-amd64"
-          chmod +x cagent
-          sudo mv cagent /usr/local/bin/
+          echo "Using Docker Agent version from DOCKER_AGENT_VERSION: ${DOCKER_AGENT_VERSION}"
+          curl -fL -o docker-agent \
+            "https://github.com/docker/docker-agent/releases/download/${DOCKER_AGENT_VERSION}/docker-agent-linux-amd64"
+          chmod +x docker-agent
+          sudo mv docker-agent /usr/local/bin/
 
       - name: Docker Hub login
         env:
@@ -307,7 +307,7 @@ jobs:
           set -e
           if [ -z "${HUB_ORG}" ]; then echo "::error::HUB_ORG secret is not set"; exit 1; fi
           cd review-pr/agents
-          TELEMETRY_ENABLED=false cagent share push pr-review.yaml "${HUB_ORG}/review-pr"
+          TELEMETRY_ENABLED=false docker agent share push pr-review.yaml "${HUB_ORG}/review-pr"
 
       - name: Upload README to Docker Hub
         env:

.github/workflows/security-scan.yml

@@ -17,7 +17,7 @@ permissions:
 
 jobs:
   security-scan:
-    name: Security Scan with cagent
+    name: Security Scan with Docker Agent
     runs-on: ubuntu-latest
     env:
       HAS_APP_SECRETS: ${{ secrets.CAGENT_REVIEWER_APP_ID != '' }}

.github/workflows/test.yml

@@ -186,7 +186,7 @@ jobs:
         run: |
           OUTPUT_FILE="${{ steps.invalid-agent.outputs.output-file }}"
 
-          # Check exit code OR check for error in output (cagent may exit 0 even on pull failure)
+          # Check exit code OR check for error in output (Docker Agent may exit 0 even on pull failure)
           if [ "${{ steps.invalid-agent.outputs.exit-code }}" == "0" ]; then
             # Exit code is 0, check if output contains error message
             if [ -f "$OUTPUT_FILE" ] && grep -q "failed to pull" "$OUTPUT_FILE"; then

.github/workflows/update-cagent-version.yml

@@ -1,12 +1,12 @@
-name: Update cagent version
+name: Update Docker Agent version
 
 on:
   repository_dispatch:
     types: [cagent-release]
   workflow_dispatch:
     inputs:
       version:
-        description: "cagent version (e.g., v1.28.1). Leave empty to use latest release."
+        description: "Docker Agent version (e.g., v1.28.1). Leave empty to use latest release."
         required: false
         type: string
 
@@ -43,8 +43,8 @@ jobs:
             VERSION="$DISPATCH_VERSION"
             echo "Using dispatched version: $VERSION"
           else
-            echo "No version specified, fetching latest release from docker/cagent..."
-            VERSION=$(gh release view --repo docker/cagent --json tagName --jq '.tagName')
+            echo "No version specified, fetching latest release from docker/docker-agent..."
+            VERSION=$(gh release view --repo docker/docker-agent --json tagName --jq '.tagName')
             echo "Latest release: $VERSION"
           fi
 
@@ -55,9 +55,9 @@ jobs:
           GH_TOKEN: ${{ steps.app-token.outputs.token || secrets.RELEASE_TOKEN }}
           VERSION: ${{ steps.version.outputs.version }}
         run: |
-          echo "Validating that $VERSION exists as a release on docker/cagent..."
-          if ! gh release view "$VERSION" --repo docker/cagent > /dev/null 2>&1; then
-            echo "❌ Release $VERSION not found on docker/cagent"
+          echo "Validating that $VERSION exists as a release on docker/docker-agent..."
+          if ! gh release view "$VERSION" --repo docker/docker-agent > /dev/null 2>&1; then
+            echo "❌ Release $VERSION not found on docker/docker-agent"
             exit 1
           fi
           echo "✅ Release $VERSION exists"
@@ -67,7 +67,7 @@ jobs:
         env:
           VERSION: ${{ steps.version.outputs.version }}
         run: |
-          CURRENT=$(cat CAGENT_VERSION | tr -d '[:space:]')
+          CURRENT=$(cat DOCKER_AGENT_VERSION | tr -d '[:space:]')
           echo "Current version: $CURRENT"
           echo "Target version:  $VERSION"
 
@@ -80,13 +80,13 @@ jobs:
             echo "current=$CURRENT" >> "$GITHUB_OUTPUT"
           fi
 
-      - name: Update CAGENT_VERSION
+      - name: Update DOCKER_AGENT_VERSION
         if: steps.check.outputs.skip != 'true'
         env:
           VERSION: ${{ steps.version.outputs.version }}
         run: |
-          echo "$VERSION" > CAGENT_VERSION
-          echo "Updated CAGENT_VERSION to $VERSION"
+          echo "$VERSION" > DOCKER_AGENT_VERSION
+          echo "Updated DOCKER_AGENT_VERSION to $VERSION"
 
       - name: Create or update PR
         if: steps.check.outputs.skip != 'true'
@@ -95,7 +95,7 @@ jobs:
           VERSION: ${{ steps.version.outputs.version }}
           CURRENT: ${{ steps.check.outputs.current }}
         run: |
-          BRANCH="auto/update-cagent-version"
+          BRANCH="auto/update-docker-agent-version"
           RELEASE_URL="https://github.com/docker/docker-agent/releases/tag/$VERSION"
 
           # Configure git
@@ -104,8 +104,8 @@ jobs:
 
           # Create or reset branch
           git checkout -B "$BRANCH"
-          git add CAGENT_VERSION
-          git commit -m "chore: update cagent to $VERSION"
+          git add DOCKER_AGENT_VERSION
+          git commit -m "chore: update Docker Agent to $VERSION"
 
           # Force-push to handle both new and existing branches.
           # This branch is exclusively managed by this workflow, so --force is safe.
@@ -117,25 +117,25 @@ jobs:
           if [ -n "$EXISTING_PR" ]; then
             echo "Updating existing PR #$EXISTING_PR"
             gh pr edit "$EXISTING_PR" \
-              --title "chore: update cagent to $VERSION" \
+              --title "chore: update Docker Agent to $VERSION" \
               --body "$(cat <<EOF
           ## Summary
-          Updates \`CAGENT_VERSION\` from \`$CURRENT\` to \`$VERSION\`.
+          Updates \`DOCKER_AGENT_VERSION\` from \`$CURRENT\` to \`$VERSION\`.
           - **Release**: [$VERSION]($RELEASE_URL)
           - **Triggered by**: \`${{ github.event_name }}\`
-          > Auto-generated by the [update-cagent-version](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) workflow.
+          > Auto-generated by the [update-docker-agent-version](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) workflow.
           EOF
           )"
           else
             echo "Creating new PR"
             gh pr create \
-              --title "chore: update cagent to $VERSION" \
+              --title "chore: update Docker Agent to $VERSION" \
               --body "$(cat <<EOF
           ## Summary
-          Updates \`CAGENT_VERSION\` from \`$CURRENT\` to \`$VERSION\`.
+          Updates \`DOCKER_AGENT_VERSION\` from \`$CURRENT\` to \`$VERSION\`.
           - **Release**: [$VERSION]($RELEASE_URL)
           - **Triggered by**: \`${{ github.event_name }}\`
-          > Auto-generated by the [update-cagent-version](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) workflow.
+          > Auto-generated by the [update-docker-agent-version](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) workflow.
           EOF
           )" \
               --label "kind/dependencies"

CAGENT_VERSION

@@ -0,0 +1 @@
+v1.36.1

DOCKER_AGENT_VERSION

@@ -1,6 +1,6 @@
 # cagent GitHub Action
 
-A GitHub Action for running [Docker Agent](https://github.com/docker/docker-agent) AI agents in your workflows. This action simplifies the setup and execution of cagent, handling binary downloads and environment configuration automatically.
+A GitHub Action for running [Docker Agent](https://github.com/docker/docker-agent) AI agents in your workflows. This action simplifies the setup and execution of Docker Agent, handling binary downloads and environment configuration automatically.
 
 ## Quick Start
 
@@ -19,7 +19,7 @@ A GitHub Action for running [Docker Agent](https://github.com/docker/docker-agen
    - Add `ANTHROPIC_API_KEY` (or another provider's key) from [Anthropic Console](https://console.anthropic.com/)
 
 3. **That's it!** The action will automatically:
-   - Download the cagent binary
+   - Download the Docker Agent binary
    - Run your specified agent
    - Scan outputs for leaked secrets
    - Provide results in workflow logs
@@ -92,7 +92,7 @@ See the [full PR Review documentation](review-pr/README.md) for more details.
 ### Advanced Configuration
 
 ```yaml
-- name: Run cagent with Custom Settings
+- name: Run Docker Agent with Custom Settings
   uses: docker/cagent-action@latest
   with:
     agent: docker/code-analyzer
@@ -111,7 +111,7 @@ See the [full PR Review documentation](review-pr/README.md) for more details.
 ### Using Outputs
 
 ```yaml
-- name: Run cagent
+- name: Run Docker Agent
   id: agent
   uses: docker/cagent-action@latest
   with:
@@ -158,16 +158,16 @@ See the [full PR Review documentation](review-pr/README.md) for more details.
 | `yolo`                     | Auto-approve all prompts (`true`/`false`)                                            | No       | `true`         |
 | `max-retries`              | Maximum number of retries on failure (0 = no retries)                                | No       | `2`            |
 | `retry-delay`              | Base delay in seconds between retries (doubles each attempt)                         | No       | `5`            |
-| `extra-args`               | Additional arguments to pass to `cagent run`                                         | No       | -              |
+| `extra-args`               | Additional arguments to pass to `docker agent run`                                   | No       | -              |
 | `add-prompt-files`         | Comma-separated list of files to append to the prompt (e.g., `AGENTS.md,CLAUDE.md`)  | No       | -              |
 
 ### Prompt Files (`add-prompt-files`)
 
-The `add-prompt-files` input allows you to include additional context files as system messages. This uses cagent's `--prompt-file` flag under the hood.
+The `add-prompt-files` input allows you to include additional context files as system messages. This uses Docker Agent's `--prompt-file` flag under the hood.
 
 > **Note:** The `review-pr` action automatically reads `AGENTS.md` and `CLAUDE.md` from the repository root — you don't need to specify them via `add-prompt-files`. Use this input for additional files beyond those defaults.
 
-**File Resolution (handled by cagent):**
+**File Resolution (handled by Docker Agent):**
 
 - Searches up the directory hierarchy (like `.gitignore`)
 - Also checks the home folder (`~/`)
@@ -188,7 +188,7 @@ add-prompt-files: "STYLE_GUIDE.md"  # Found via hierarchy search
 
 | Output                  | Description                                              |
 | ----------------------- | -------------------------------------------------------- |
-| `exit-code`             | Exit code from cagent run                                |
+| `exit-code`             | Exit code from docker agent run                          |
 | `output-file`           | Path to the output log file                              |
 | `mcp-gateway-installed` | Whether mcp-gateway was installed (`true`/`false`)       |
 | `execution-time`        | Agent execution time in seconds                          |