refactor: Adjusted the parsing of remote URLs to include repository information.

Author: Joan-Angelo Enrile

.claude-plugin/marketplace.json

@@ -5,22 +5,22 @@
   },
   "metadata": {
     "description": "AI Agent plugin marketplace for the Azure DevOps CLI",
-    "version": "1.0.0",
+    "version": "1.0.3",
     "homepage": "https://github.com/yutamago/ado-cli"
   },
   "plugins": [
     {
       "name": "azure-devops",
       "source": "./plugins/azure-devops",
       "description": "Skills for interacting with Azure DevOps via the ado CLI — issues, pull requests, pipeline runs, search, and repositories.",
-      "version": "1.0.0",
+      "version": "1.0.3",
       "author": {
         "name": "yutamago",
         "url": "https://github.com/yutamago"
       },
       "category": "workflow",
       "homepage": "https://github.com/yutamago/ado-cli",
-      "keywords": ["azure-devops", "azd", "work-items", "pull-requests", "pipelines", "ci-cd"]
+      "keywords": ["azure-devops", "ado", "work-items", "pull-requests", "pipelines", "ci-cd"]
     }
   ]
 }

.vscode/launch.json

@@ -0,0 +1,16 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "ado: debug local (bun)",
+      "type": "bun",
+      "request": "launch",
+      "program": "${workspaceFolder}/src/index.ts",
+      "args": [
+        "pr",
+        "list"
+      ],
+      "cwd": "/home/angelo/workspaces/stp_ws/Winsolvenz.Assist"
+    }
+  ]
+}

CLAUDE.md

@@ -21,7 +21,7 @@ src/
     builds.ts            # Pipeline run list/view/cancel/rerun/download/delete
     search.ts            # Code (Azure Search REST), commits, repos (client-side filter)
   auth/
-    store.ts             # Keytar + ~/.azd/credentials.json fallback
+    store.ts             # Keytar + ~/.ado/credentials.json fallback
     oauth.ts             # MSAL OAuth2 (browser + device-code flows)
   commands/
     auth/                # login, logout, status
@@ -31,9 +31,9 @@ src/
     search/              # issues, code, commits, prs, repos, projects
     repo/                # list, clone
     completion.ts        # Shell completions (bash/zsh/fish/powershell)
-  config/index.ts        # Config load: CLI > env > git remote > ~/.azd/config.json
+  config/index.ts        # Config load: CLI > env > git remote > ~/.ado/config.json
   output/index.ts        # TTY/non-TTY formatting, table, detail, JSON
-  errors/index.ts        # AzdError, AuthError, NotFoundError, ConfigError
+  errors/index.ts        # AdoError, AuthError, NotFoundError, ConfigError
 ```
 
 ## Authentication Architecture
@@ -43,13 +43,13 @@ Credential resolution order in `src/api/client.ts`:
 2. `AZURE_DEVOPS_TOKEN` env var — explicit PAT for scripts/CI
 3. Stored credential (OAuth token or PAT) — persisted across sessions
 
-OAuth uses MSAL `PublicClientApplication` with browser redirect (loopback), falling back to device-code for headless environments. Tokens are stored via keytar (native credential manager) with `~/.azd/credentials.json` as a file fallback.
+OAuth uses MSAL `PublicClientApplication` with browser redirect (loopback), falling back to device-code for headless environments. Tokens are stored via keytar (native credential manager) with `~/.ado/credentials.json` as a file fallback.
 
-Config location: `~/.azd/` (`config.json`, `credentials.json`, `oauth-cache.json`)
+Config location: `~/.ado/` (`config.json`, `credentials.json`, `oauth-cache.json`)
 
 ## Configuration Resolution Order
 
-CLI flags → environment variables → git remote (auto-detect org/project) → `~/.azd/config.json`
+CLI flags → environment variables → git remote (auto-detect org/project) → `~/.ado/config.json`
 
 Environment variables: `AZURE_DEVOPS_TOKEN`, `SYSTEM_ACCESSTOKEN`, `AZURE_DEVOPS_ORG`, `AZURE_DEVOPS_PROJECT`
 
@@ -73,7 +73,7 @@ Git remote formats supported:
 
 ## Keeping the Plugin Reference Up to Date
 
-`plugins/azd/skills/azd-cli/reference.md` is the authoritative CLI reference used by the ado plugin skill.
+`plugins/ado/skills/ado-cli/reference.md` is the authoritative CLI reference used by the ado plugin skill.
 
 **Update it whenever you:**
 - Add, rename, or remove a command or subcommand
@@ -86,7 +86,7 @@ Keep the reference in sync with the source — it is generated from the actual `
 
 ## Core Principles
 
-- `azd` commands should work the same as their `gh` counterparts, unless the Azure DevOps API makes this impossible.
+- `ado` commands should work the same as their `gh` counterparts, unless the Azure DevOps API makes this impossible.
 - If the user uses an unrecognized command, return a clear message explaining the wrong usage and how to properly use the command.
 - The core target audience for this CLI is Agents (such as Claude and GitHub Copilot).
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 azd-cli contributors
+Copyright (c) 2026 ado-cli contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -122,7 +122,7 @@ ado repo clone <repo>
 ```bash
 ado completion bash        >> ~/.bashrc
 ado completion zsh         >> ~/.zshrc
-ado completion fish        > ~/.config/fish/completions/azd.fish
+ado completion fish        > ~/.config/fish/completions/ado.fish
 ado completion powershell  >> $PROFILE
 ```
 
@@ -146,7 +146,7 @@ Config is resolved in this order:
 1. CLI flags (`--org`, `--project`)
 2. Environment variables (`AZURE_DEVOPS_ORG`, `AZURE_DEVOPS_PROJECT`)
 3. Git remote (auto-detected from `origin`)
-4. `~/.azd/config.json`
+4. `~/.ado/config.json`
 
 Supported remote URL formats:
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ado-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "An Azure DevOps CLI, mimicking the known and loved Github CLI syntax.",
   "main": "./dist/index.js",
   "bin": {

plugins/azure-devops/plugin.json

@@ -1,6 +1,6 @@
 {
-  "name": "azd",
-  "version": "1.0.0",
+  "name": "ado",
+  "version": "1.0.3",
   "description": "Azure DevOps skills for AI Agents — issues, pull requests, pipeline runs, search, and repositories.",
   "author": {
     "name": "yutamago",

plugins/azure-devops/skills/azure-devops/SKILL.md

@@ -14,11 +14,11 @@ description: >
 
 # ado CLI Skill
 
-`azd` is an Azure DevOps CLI optimized for agentic use. It mirrors GitHub CLI (`gh`) conventions so commands map predictably. All commands are non-interactive by default; TTY output is styled tables, non-TTY output is tab-separated plain text (pipeline-safe). Use `--json` for structured JSON.
+`ado` is an Azure DevOps CLI optimized for agentic use. It mirrors GitHub CLI (`gh`) conventions so commands map predictably. All commands are non-interactive by default; TTY output is styled tables, non-TTY output is tab-separated plain text (pipeline-safe). Use `--json` for structured JSON.
 
-## First Run: Detect Installation
+## On Errors: Detect Installation
 
-**Run this check once at the start of each session, before any other command.**
+**Run this check once per session if the first `ado` command fails, before continuing with any other command.**
 
 Check for the `ado` binary in this order:
 
@@ -59,22 +59,15 @@ Once installed, run `ado --version` to confirm, then retry your original request
 
 ## Authentication
 
-Credential resolution order (highest to lowest priority):
-
-1. `SYSTEM_ACCESSTOKEN` env var — Azure Pipelines built-in token (CI)
-2. `AZURE_DEVOPS_TOKEN` env var — explicit PAT for scripts/CI
-3. Stored credential from `ado auth login` (OAuth token or PAT)
-
-### Login
-
+If the CLI returns an authentication error, prompt the user to run one of the following commands to log in:
 ```bash
 ado auth login                          # OAuth browser flow (default)
 ado auth login --with-token             # PAT via stdin: echo $PAT | ado auth login --with-token
 ado auth login --token <pat>            # PAT inline
-ado auth login --org <url>             # Specify org URL at login time
+ado auth login --org <url>              # Specify org URL at login time
 ```
 
-After login, select a default project interactively, or set env vars:
+After login, the CLI attempts to select a default project interactively, or set env vars:
 
 ```bash
 export AZURE_DEVOPS_ORG=https://dev.azure.com/myorg
@@ -89,7 +82,7 @@ ado auth status --json
 
 ## Configuration Resolution Order
 
-CLI flags → environment variables → git remote (auto-detect) → `~/.azd/config.json`
+CLI flags → environment variables → git remote (auto-detect) → `~/.ado/config.json`
 
 Git remote formats supported: `https://dev.azure.com/{org}/{project}/_git/{repo}`, `https://{org}.visualstudio.com/{project}/_git/{repo}`, `git@ssh.dev.azure.com:v3/{org}/{project}/{repo}`
 
@@ -232,4 +225,4 @@ ado repo clone my-repo ./local-dir
 
 For the complete flag inventory (every flag, short alias, default, and accepted values for every subcommand), read:
 
-`${CLAUDE_PLUGIN_ROOT}/skills/azd-cli/reference.md`
+`${CLAUDE_PLUGIN_ROOT}/skills/ado-cli/reference.md`

src/api/pullRequests.ts

@@ -6,7 +6,7 @@ import {
 import { createTwoFilesPatch } from 'diff';
 import { minimatch } from 'minimatch';
 import { handleApiError } from '../errors/index.js';
-import { AzdError } from '../errors/index.js';
+import { AdoError } from '../errors/index.js';
 
 export interface PrSummary {
   id: number;
@@ -282,7 +282,7 @@ export async function getPrDiff(
     const targetCommit = pr.lastMergeTargetCommit?.commitId;
 
     if (!sourceCommit || !targetCommit) {
-      throw new AzdError('PR does not have committed changes yet.');
+      throw new AdoError('PR does not have committed changes yet.');
     }
 
     // Get changed files from the latest iteration
@@ -415,7 +415,7 @@ export async function reviewPullRequest(
     const connData = await connection.connect();
     const userId = connData?.authenticatedUser?.id;
     if (!userId) {
-      throw new AzdError('Could not determine current user identity.');
+      throw new AdoError('Could not determine current user identity.');
     }
 
     await gitApi.createPullRequestReviewer(
@@ -441,13 +441,13 @@ export async function resolveRepo(
   const repos = await gitApi.getRepositories(project);
 
   if (!repos || repos.length === 0) {
-    throw new AzdError(`No repositories found in project '${project}'.`);
+    throw new AdoError(`No repositories found in project '${project}'.`);
   }
   if (repos.length === 1) {
     return repos[0].name ?? '';
   }
 
-  throw new AzdError(
+  throw new AdoError(
     `Multiple repositories found. Specify one with --repo:\n` +
     repos.map(r => `  ${r.name}`).join('\n')
   );

src/auth/store.ts

@@ -2,7 +2,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { getConfigDir } from '../config/index.js';
 
-const KEYTAR_SERVICE = 'azd-cli';
+const KEYTAR_SERVICE = 'ado-cli';
 const KEYTAR_OAUTH_CACHE_ACCOUNT = '__oauth_cache__';
 
 const CREDENTIALS_FILE = path.join(getConfigDir(), 'credentials.json');