Autocoder

Run code agents directly from your Azure DevOps pipelines to generate code based on work items or custom prompts and (optionally) create pull requests with the changes.

Features

• Generate code based on Azure DevOps work items or custom user prompts.
• Support for Github Copilot CLI and Anthropic Claude Code agents.
• Automatic creation of pull requests with the generated code changes.
• Runs in container for isolation and compatibility.
• Configurable system prompts and container images for advanced customization.

Prerequisites

• An Azure DevOps organization with a repository containing your codebase.
• A Github Copilot Token or Anthropic Console API Key for Claude Code access.
• Repository permissions for the build service identity to create branches and pull requests, or a personal access token (PAT) with appropriate scopes.

Configuration

1. Install the Autocoder extension from the Azure DevOps Marketplace.
2. Add a checkout step to your pipeline to ensure the codebase is available. This is required for the Autocoder task to function correctly.
3. Add the Autocoder task to your build or release pipeline.
4. Add any necessary variables or secrets to your pipeline for the API keys or tokens.
5. Add an optional, but recommended step to publish the autocoder logs as pipeline artifacts for easier debugging. The logs will be avialable in the '$(Build.ArtifactStagingDirectory)/autocoder.log' file.
6. Configured the required permissions:

• Contribute: To create branches and push changes.
• Contribute to pull requests: To create and update pull requests with the generated code changes.

6. Save and run your pipeline. The Autocoder task will generate code based on the specified work item or prompt and optionally create a pull request with the changes.

Here is an example of how to use the Autocoder task with Github Copilot in a YAML pipeline:

trigger:
- none

pool:
  vmImage: ubuntu-latest

parameters:
  - name: WorkItemId
    displayName: Work Item Id (1234)(Optional)
    type: number
    default: 0

  - name: UserPrompt
    displayName: User Prompt or Additional Context(Optional)
    type: string
    default: empty

  - name: CreatePullRequest
    displayName: Create Pull Reuqest
    type: boolean
    default: true

variables:
  - group: GITHUB

  - name: userPrompt
    ${{ if eq(parameters.UserPrompt, 'empty') }}:
      value: ''
    ${{ else }}:
      value: ${{ parameters.UserPrompt }}

  - name: workItemId
    ${{ if eq(parameters.WorkItemId, 0) }}:
      value: ''
    ${{ else }}:
      value: ${{ parameters.WorkItemId }}

steps:

- checkout: self
  fetchDepth: 0  # Full clone
  persistCredentials: true

- task: Autocoder@1
  inputs:
    workItemId: '$(workItemId)'
    userPrompt: '$(userPrompt)'
    agentType: 'copilot'
    apiKey: '$(GITHUB_PAT)'
    createPullRequest: ${{ parameters.CreatePullRequest }}
    # Optional: specify a model to use
    # model: 'gpt-5.2-codex'

- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'drop'
    publishLocation: 'Container'
  condition: true

And here is an example of how to use the Autocoder task with Claude Code in a YAML pipeline:

trigger:
- none

pool:
  vmImage: ubuntu-latest

parameters:
  - name: WorkItemId
    displayName: Work Item Id (1234)(Optional)
    type: number
    default: 0

  - name: UserPrompt
    displayName: User Prompt or Additional Context(Optional)
    type: string
    default: empty

  - name: CreatePullRequest
    displayName: Create Pull Reuqest
    type: boolean
    default: true

variables:
  - group: ANTHROPIC

  - name: userPrompt
    ${{ if eq(parameters.UserPrompt, 'empty') }}:
      value: ''
    ${{ else }}:
      value: ${{ parameters.UserPrompt }}

  - name: workItemId
    ${{ if eq(parameters.WorkItemId, 0) }}:
      value: ''
    ${{ else }}:
      value: ${{ parameters.WorkItemId }}

steps:

- checkout: self
  fetchDepth: 0  # Full clone
  persistCredentials: true

- task: Autocoder@1
  inputs:
    workItemId: '$(workItemId)'
    userPrompt: '$(userPrompt)'
    agentType: 'claude'
    apiKey: '$(ANTHROPIC_API_KEY)'
    createPullRequest: ${{ parameters.CreatePullRequest }}
    # Optional: specify a model to use
    # model: 'claude-3-5-sonnet-20241022'

- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'drop'
    publishLocation: 'Container'
  condition: true

Example

For the following work item:

When running the example pipeline, the input should look like this:

And the resulting pull request should look like this:

Task parameters