{"id":16953,"library":"azdo-cli","title":"Azure DevOps CLI Tool","description":"The `azdo-cli` package provides a command-line interface for interacting with Azure DevOps services. It allows users to manage various Azure DevOps resources, such as work items, pull requests, and comments, directly from their terminal. The current stable version, as indicated by the latest release, is v0.9.0. The project exhibits an active development cadence, with frequent minor feature releases and dependency updates, suggesting ongoing maintenance and expansion of its capabilities. It serves as a lightweight alternative for automating Azure DevOps tasks and integrating them into scripts, potentially offering a more streamlined experience for specific use cases compared to the broader `az devops` extension for the Azure CLI, focusing on developer-centric operations.","status":"active","version":"0.8.1","language":"javascript","source_language":"en","source_url":"https://github.com/alkampfergit/azdo-cli","tags":["javascript"],"install":[{"cmd":"npm install azdo-cli","lang":"bash","label":"npm"},{"cmd":"yarn add azdo-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add azdo-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"# Install globally (recommended for CLI tools)\nnpm install -g azdo-cli\n\n# Alternatively, use npx for single execution without global install\n# npx azdo-cli --version\n\n# Configure authentication using a Personal Access Token (PAT)\n# Set your Azure DevOps organization and project\n# Replace 'your-organization' and 'your-project' with actual values\n# The PAT can be set as an environment variable (AZDO_PAT) for security\nexport AZDO_PAT=\"YOUR_AZURE_DEVOPS_PAT\"\nazdo-cli config set organization \"your-organization\"\nazdo-cli config set project \"your-project\"\n\n# Example: List all work items in the configured project\nazdo-cli work-item list\n\n# Example: Create a new bug work item\nazdo-cli work-item create --type \"Bug\" --title \"Broken user profile image upload\" --description \"Users are reporting issues when trying to upload new profile pictures after the last deployment.\" --assigned-to \"developer@example.com\"\n\n# Example: Add a comment to an existing pull request (replace 123 and repo-name)\nazdo-cli pr comment add --id 123 --repository \"your-repo-name\" --comment \"Initial review complete. Looks good, minor stylistic changes suggested.\"","lang":"bash","description":"This quickstart demonstrates how to install `azdo-cli`, configure it with your Azure DevOps organization and a Personal Access Token (PAT), and then provides examples for listing work items, creating a new bug, and adding a comment to a pull request using the command-line interface."},"warnings":[{"fix":"After upgrading to v0.4.0 or newer, explicitly re-run `azdo-cli config set` for any sensitive configurations like `AZDO_PAT` or ensure they are correctly set via environment variables.","message":"The `better-secret` feature introduced in v0.4.0 might have changed how secrets are managed or stored. Users upgrading from versions prior to v0.4.0 may need to re-configure their Personal Access Tokens (PATs) or other sensitive credentials.","severity":"breaking","affected_versions":"<0.4.0"},{"fix":"Verify and update the scopes of your Personal Access Token in Azure DevOps under 'User settings' -> 'Personal access tokens' to match the permissions required by the commands you intend to use.","message":"Personal Access Tokens (PATs) used for authentication must have the correct scopes enabled in Azure DevOps (e.g., 'Work Items (Read & Write)', 'Code (Read & Write)') for `azdo-cli` commands to function properly. Insufficient scopes will lead to authorization errors.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Ensure that `azdo-cli config set organization \"your-org\"` and `azdo-cli config set project \"your-project\"` have been executed, or include `--organization \"your-org\" --project \"your-project\"` with relevant commands.","message":"Many commands require explicit `--organization` and `--project` flags if they are not set globally via `azdo-cli config set` or through environment variables. Failure to specify these can result in 'resource not found' or 'command scope' errors.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Set `export AZDO_PAT=\"YOUR_PAT_HERE\"` in your shell profile or use a secret management system, then `azdo-cli` will automatically pick it up without needing `config set` for the PAT.","message":"Sensitive data like Personal Access Tokens (PATs) should ideally be managed via environment variables (e.g., `AZDO_PAT`) rather than storing them directly in shell history or less secure configuration files, especially in shared environments.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"fix":"Run `npm install -g azdo-cli` to install it globally, or use `npx azdo-cli [command]` to execute it without a global installation.","cause":"The `azdo-cli` package is not installed globally or is not in your system's PATH.","error":"azdo-cli: command not found"},{"fix":"Verify your `AZDO_PAT` environment variable or the PAT configured via `azdo-cli config set`, ensure it's not expired and has the necessary scopes. Double-check the spelling of your organization and project names.","cause":"The provided Personal Access Token (PAT) is invalid, expired, has incorrect scopes, or the Azure DevOps organization/project is misspelled or inaccessible.","error":"Error: Failed to authenticate. Please check your PAT or organization/project settings."},{"fix":"Consult the command's help (`azdo-cli work-item create --help`) and provide all mandatory arguments, such as `--title` for creating a work item.","cause":"A command like `work-item create` requires specific arguments that were not provided.","error":"Error: Missing required argument: --title"},{"fix":"Verify the ID and name of the resource you are trying to access. Ensure you are operating within the correct Azure DevOps organization and project context.","cause":"The specified resource (e.g., work item ID, pull request ID, repository name) does not exist or is inaccessible within the configured project/organization.","error":"Error: Resource '123' not found in repository 'my-repo'."}],"ecosystem":"npm","meta_description":null}