Azure DevOps Integration | Rocket.new Build

For teams who plan work in Azure DevOps and build in Rocket. Connect so you can build or fix from a work item or wiki URL and update Azure DevOps from chat. After you set env vars, your app can call Azure DevOps APIs.

You need two pieces: the connector (Azure DevOps as generation context for Rocket) and environment variables plus a PAT (so your generated app can call Azure DevOps APIs). Connect at workspace level (Settings, shared across tasks) or task level (Connectors tab or chat).

Before you start: a Microsoft account with access to the target Azure DevOps organization and project; permission to approve OAuth (or an admin if you see Need admin approval); a Personal Access Token you can create (or an admin policy that allows it); and the organization name from https://dev.azure.com/{organization} plus the project name for env vars. Use the same organization in Select Organization and AZURE_DEVOPS_ORG.

What you can do

Build from a work item

Paste a user story or task URL. Rocket reads requirements and acceptance criteria, then generates the feature.

Fix a bug from a report

Paste a bug URL. Rocket reads reproduce steps and expected vs actual behavior, then produces a targeted fix.

Build from the current sprint

Ask Rocket to read the active sprint and build the highest-priority work first.

Use repo and pull request context

Point Rocket at a repository or pull request so new code matches your existing patterns.

Fix a failing pipeline

Paste a failing build URL. Rocket checks the logs and fixes the issue in the app.

Build from a wiki page

Paste a wiki URL. Rocket follows the specs on that page when generating the feature.

Connect Azure DevOps

Authorize with Microsoft, then select the organization Rocket should use. You can also connect from workspace Settings.

Web Browser
Mobile App

Open the overflow menu

In the preview toolbar, click the ... button.

Rocket preview toolbar with the three-dot overflow menu highlighted. — Open the overflow menu in the preview toolbar

Choose Connectors

Select Connectors from the menu.

Overflow menu with Connectors highlighted. — Choose Connectors from the menu

Open Azure DevOps

Click the Azure DevOps card.

Connectors list with the Azure DevOps card highlighted. — Open the Azure DevOps connector

Click Connect

On the Azure DevOps connector page, click Connect.

Azure DevOps connector detail page with the Connect button highlighted. — Click Connect on the Azure DevOps connector

Authorize with Microsoft

A Microsoft sign-in screen opens. Sign in with an account that has access to your Azure DevOps organization, review the permissions Rocket requests, and approve access. You return to Rocket when authorization completes.

Select organization

Under Select Organization, choose which Azure DevOps organization to connect, then confirm. When the connection is active, Disconnect is available on the connector page.

If you cannot see the organization or project

Your account needs access to the organization and project you intend to use. Admins can add organization users and grant project access. OAuth approval alone does not grant admin rights; see the Azure DevOps permissions reference.

Disconnect a service

Disconnect or switch accounts from workspace Settings.

Set environment variables

These three values are for the generated app, not for signing into the connector. Use the same organization you chose under Select Organization.

Create a PAT and find org or project names

Create a Personal Access Token in Azure DevOps with Microsoft’s Personal Access Token guide. If PAT creation or scopes are restricted, see PAT policies for administrators. The organization name appears in https://dev.azure.com/{organization}; the project name is in the project selector and URL. See Microsoft’s guides for finding organizations and viewing projects.

Variable	Purpose
`AZURE_DEVOPS_ORG`	Azure DevOps organization name
`AZURE_DEVOPS_PROJECT`	Project within that organization
`AZURE_DEVOPS_PAT`	Personal Access Token for app API auth

Reference them in server-side code as process.env.AZURE_DEVOPS_ORG, process.env.AZURE_DEVOPS_PROJECT, and process.env.AZURE_DEVOPS_PAT.

Never paste your Personal Access Token into chat, and never share passwords, OAuth tokens, refresh tokens, client secrets, or PATs with support. Add placeholders in .env, then set real values in Environment settings. If a token is exposed, revoke it in Azure DevOps and create a new one.

Add placeholders in `.env`

Open the Code tab and add:

AZURE_DEVOPS_ORG=your-org
AZURE_DEVOPS_PROJECT=your-project
AZURE_DEVOPS_PAT=your-pat-here

Set real values in Environment

Open Settings → Environment and fill in Staging and Production for all three variables.

Ask Rocket to use these variables in your app

Ask Rocket to use these variables when building Azure DevOps-backed features in your app.

Environment variables

How to add and manage Staging and Production values in Rocket.

Example prompts

Pick the tab that matches what you are doing. Paste an Azure DevOps URL when you have one. Review changes in Azure DevOps before sharing; they appear in your org immediately.

Goal	Say this in chat
Build from a story	`Build the feature described in [ADO_URL]. Read the requirements, acceptance criteria, and linked items first.`
Fix a bug	`Fix the bug at [ADO_URL]. Read the steps to reproduce and expected vs actual behavior, then generate a targeted fix.`
See my work	`Show my assigned Azure DevOps work items in this project and suggest which one to build first.`
Search the board	`Search Azure DevOps for work items about checkout and summarize the open ones.`
Create follow-ups	`Create Azure DevOps tasks for QA and edge cases from this build, and link them under the parent story.`
Update and comment	`Move work item [ADO_URL] to Done and leave a comment describing what was built.`

Goal	Say this in chat
Build from the sprint	`Read my team's current sprint in Azure DevOps and build the highest-priority story first.`
Check the backlog	`Show the product backlog for our team and summarize what is ready to build.`
See capacity	`Check our team's capacity for the current sprint and call out who is overloaded.`
Set up a sprint	`Create a two-week sprint named Sprint 24 in Azure DevOps and assign it to our team.`

Goal	Say this in chat
Match existing code	`Use the repository and recent pull requests at [ADO_URL] as context so the new feature matches our patterns.`
Search the codebase	`Search our Azure DevOps repo for how we handle authentication and reuse that approach.`
Open a pull request	`Create a branch and open a pull request for the changes we just made, with a clear title and description.`
Review a PR	`Read the pull request at [ADO_URL], summarize the discussion, and apply any agreed fixes.`

Goal	Say this in chat
Fix a failing build	`Read the failing build at [ADO_URL], check the logs, and fix the issue in the app.`
Check status	`List our pipelines and tell me which builds failed in the last day.`
Run a pipeline	`Run the main build pipeline on the branch we just created.`
After a build	`Show the commits and work items associated with build [ADO_URL].`

Goal	Say this in chat
Build from a spec	`Read the wiki page at [ADO_URL] and build the described feature following those specs.`
Find the right page	`Search our Azure DevOps wiki for the onboarding runbook and use it as context.`
Document what shipped	`Create or update a wiki page summarizing what we built and how to try it.`

Goal	Say this in chat
See coverage	`List the test plans and suites for this project and summarize what is covered.`
Results from a build	`Pull the test results from build [ADO_URL] and summarize what failed.`
Create cases from the build	`Create a test plan with cases and steps that cover the feature we just built.`

What’s next?

Jira

Prefer Jira for tickets and sprints? Connect it for issue-driven builds.

Linear

Already using Linear? Connect it for bi-directional ticket integration.

GitHub

Push your code to a repository and keep version history.

All connectors

Browse every available integration.

BUILD

CREATE

EDITOR

CONNECTORS

POLISH

LAUNCH WEB APP

LAUNCH MOBILE APP

MEASURE

Azure DevOps

What you can do

Build from a work item

Fix a bug from a report

Build from the current sprint

Use repo and pull request context

Fix a failing pipeline

Build from a wiki page

Connect Azure DevOps

Disconnect a service

Set environment variables

Environment variables

Example prompts

What’s next?

Jira

Linear

GitHub

All connectors

​What you can do

Build from a work item

Fix a bug from a report

Build from the current sprint

Use repo and pull request context

Fix a failing pipeline

Build from a wiki page

​Connect Azure DevOps

Disconnect a service

​Set environment variables

Environment variables

​Example prompts

​What’s next?

Jira

Linear

GitHub

All connectors

What you can do

Connect Azure DevOps

Set environment variables

Example prompts

What’s next?