azp-cli 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.3.1](https://github.com/tapanmeena/azp-cli/compare/v1.3.0...v1.3.1) (2026-01-14)
+
+## [1.3.0](https://github.com/tapanmeena/azp-cli/compare/v1.2.0...v1.3.0) (2026-01-14)
+
+
+### Features
+
+* add Azure CLI installation check before authentication ([c291268](https://github.com/tapanmeena/azp-cli/commit/c291268359854e7da74a0cea046741c0449609d7))
+* update package.json with repository type; rename CLI command to 'check-update' and adjust header formatting ([8ef92d4](https://github.com/tapanmeena/azp-cli/commit/8ef92d4da233459f7631f2bf4f85ed5a4113c918))
+* update README with new features and installation instructions; refactor CLI command name to 'azp' ([24510f7](https://github.com/tapanmeena/azp-cli/commit/24510f78f44f9e1570d93c8b750aa6a41b27b62e))
+
 ## [1.2.0](https://github.com/tapanmeena/azp-cli/compare/v1.1.0...v1.2.0) (2026-01-13)
 
 

package/README.md

@@ -14,6 +14,10 @@ A command-line interface tool for managing Azure Privileged Identity Management
 - ✨ **Beautiful UI** - Polished terminal experience with spinners and colors
 - 🔄 **Multi-role Support** - Activate or deactivate multiple roles at once
 - 📊 **Status Tracking** - Real-time feedback on activation/deactivation status
+- 💾 **Presets** - Save and reuse activation/deactivation configurations
+- 🚀 **Non-interactive Mode** - CLI flags for scripting and automation
+- 🔔 **Update Notifications** - Automatic update checks with configurable behavior
+- 📤 **JSON Output** - Machine-readable output for integration with other tools
 
 ## Prerequisites
 
@@ -38,7 +42,22 @@ az account show
 
 ## Installation
 
-### From Source
+### Global Installation (Recommended)
+
+```bash
+# Using npm
+npm install -g azp-cli
+
+# Using pnpm
+pnpm add -g azp-cli
+
+# Using yarn
+yarn global add azp-cli
+```
+
+After installation, the `azp` command will be available globally.
+
+### From Source (Development)
 
 ```bash
 # Clone the repository
@@ -47,13 +66,12 @@ cd azp-cli
 
 # Install dependencies
 pnpm install
-# or
-npm install
 
 # Build the project
 pnpm build
-# or
-npm run build
+
+# Link globally for development
+npm link
 ```
 
 ## Usage
@@ -61,24 +79,38 @@ npm run build
 ### Running the CLI
 
 ```bash
-# Development mode
-pnpm dev
-# or
-npm run dev
+# After global installation
+azp
+
+# Or with specific commands
+azp activate
+azp deactivate
+azp preset list
+azp update
 
-# After building
-node dist/index.js
+# Development mode (from source)
+pnpm dev
 ```
 
 ### Commands
 
-| Command      | Alias | Description                            |
-| ------------ | ----- | -------------------------------------- |
-| `activate`   | `a`   | Activate a role in Azure PIM (default) |
-| `deactivate` | `d`   | Deactivate a role in Azure PIM         |
-| `update`     | -     | Check for a newer version              |
-| `preset`     | -     | Manage reusable presets                |
-| `help`       | -     | Display help information               |
+| Command      | Alias     | Description                            |
+| ------------ | --------- | -------------------------------------- |
+| `activate`   | `a`       | Activate a role in Azure PIM (default) |
+| `deactivate` | `d`       | Deactivate a role in Azure PIM         |
+| `preset`     | -         | Manage reusable presets                |
+| `update`     | `upgrade` | Check for a newer version              |
+| `help`       | -         | Display help information               |
+
+#### Preset Subcommands
+
+| Command         | Description                                  |
+| --------------- | -------------------------------------------- |
+| `preset list`   | List all available presets                   |
+| `preset show`   | Show details of a specific preset            |
+| `preset add`    | Add a new preset (interactive wizard)        |
+| `preset edit`   | Edit an existing preset (interactive wizard) |
+| `preset remove` | Remove a preset                              |
 
 ### Updates
 
@@ -102,9 +134,11 @@ The update-check cache is stored alongside presets in your config directory:
 - macOS/Linux: `~/.config/azp-cli/update-check.json` (or `$XDG_CONFIG_HOME/azp-cli/update-check.json`)
 - Windows: `%APPDATA%\azp-cli\update-check.json`
 
-### One-command (non-interactive) activation
+### Non-interactive Mode (Automation)
 
-Use flags to activate PIM roles directly without going through the main menu.
+Use flags to activate or deactivate PIM roles directly without going through the interactive menu, perfect for scripting and CI/CD workflows.
+
+#### Activation Examples
 
 ```bash
 # Activate a single role by name (non-interactive)
@@ -135,6 +169,43 @@ azp activate --no-interactive --dry-run \
    --output json
 ```
 
+#### Deactivation Examples
+
+```bash
+# Deactivate specific roles
+azp deactivate --no-interactive --yes \
+   --subscription-id <SUBSCRIPTION_GUID> \
+   --role-name "Owner" \
+   --justification "Task completed"
+
+# Deactivate across all subscriptions (omit subscription-id)
+azp deactivate --no-interactive --yes \
+   --role-name "Contributor" \
+   --allow-multiple
+```
+
+#### Available Flags
+
+**Common flags (activate/deactivate):**
+
+- `--no-interactive` - Disable interactive prompts
+- `-y, --yes` - Skip confirmation prompts
+- `--subscription-id <id>` - Target subscription (optional for deactivate)
+- `--role-name <name>` - Role name(s) to target (can be repeated)
+- `--allow-multiple` - Allow multiple role matches
+- `--dry-run` - Preview without submitting
+- `--output <text|json>` - Output format (default: text)
+- `--quiet` - Suppress non-essential output
+
+**Activation-specific:**
+
+- `--duration-hours <n>` - Duration (1-8 hours, default varies by role)
+- `--justification <text>` - Justification for activation
+
+**Deactivation-specific:**
+
+- `--justification <text>` - Justification for deactivation (optional)
+
 ## Presets
 
 Presets let you save your daily activation/deactivation routines (subscription + role names + duration + justification) and reuse them with `--preset <name>`.
@@ -163,24 +234,27 @@ A preset can define one or both blocks:
 - `${datetime}` → ISO timestamp
 - `${userPrincipalName}` → resolved from Microsoft Graph `/me`
 
-### Common workflows
+### Common Workflows
 
 ```bash
 # Create a preset (interactive wizard)
 azp preset add daily-ops
 
+# Create a preset with Azure integration (fetches subscriptions/roles)
+azp preset add daily-ops --from-azure
+
 # Edit a preset (interactive wizard)
 azp preset edit daily-ops
 
-# You can also re-run add to overwrite an existing preset
-azp preset add daily-ops
-
-# List presets
+# List all presets
 azp preset list
 
-# Show one preset
+# Show one preset details
 azp preset show daily-ops
 
+# Remove a preset
+azp preset remove daily-ops
+
 # Use a preset (flags still override preset values)
 azp activate --preset daily-ops --yes
 
@@ -293,6 +367,8 @@ git push --follow-tags
 4. Publish to npm (if desired):
 
 ```bash
+npm publish
+# or
 pnpm publish
 ```
 
@@ -301,11 +377,14 @@ pnpm publish
 ```
 azp-cli/
 ├── src/
-│   ├── index.ts      # CLI entry point and command definitions
-│   ├── auth.ts       # Azure authentication handling
-│   ├── azure-pim.ts  # Azure PIM API operations
-│   ├── cli.ts        # Interactive menu and user flows
-│   └── ui.ts         # Terminal UI utilities (spinners, formatting)
+│   ├── index.ts          # CLI entry point and command definitions
+│   ├── auth.ts           # Azure authentication handling
+│   ├── azure-pim.ts      # Azure PIM API operations
+│   ├── cli.ts            # Interactive menu and user flows
+│   ├── presets.ts        # Preset configuration and storage
+│   ├── presets-cli.ts    # Preset wizard flows
+│   ├── ui.ts             # Terminal UI utilities (spinners, formatting)
+│   └── update-check.ts   # Update notification system
 ├── package.json
 ├── tsconfig.json
 └── README.md

package/package.json

@@ -1,19 +1,11 @@
 {
   "name": "azp-cli",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Terminal app to manage Azure PIM role activations",
   "main": "dist/index.js",
   "bin": {
     "azp": "./dist/index.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "ts-node -r tsconfig-paths/register src/index.ts",
-    "lint": "tsc -p tsconfig.json --noEmit",
-    "release": "standard-version",
-    "release:dry": "standard-version --dry-run"
-  },
   "keywords": [
     "azure",
     "pim",
@@ -25,8 +17,12 @@
     "name": "Tapan Meena",
     "email": "tapanmeena1998@gmail.com"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tapanmeena/azp-cli.git"
+  },
+  "homepage": "https://github.com/tapanmeena/azp-cli#readme",
   "license": "ISC",
-  "packageManager": "pnpm@10.28.0",
   "dependencies": {
     "@azure/arm-authorization": "^9.0.0",
     "@azure/arm-resources-subscriptions": "^2.1.0",
@@ -47,5 +43,13 @@
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node -r tsconfig-paths/register src/index.ts",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "release": "standard-version",
+    "release:dry": "standard-version --dry-run"
   }
-}
+}

package/src/auth.ts

@@ -1,3 +1,5 @@
+import { exec } from "child_process";
+import { promisify } from "util";
 import { AzureCliCredential } from "@azure/identity";
 import { Client } from "@microsoft/microsoft-graph-client";
 import { TokenCredentialAuthenticationProvider } from "@microsoft/microsoft-graph-client/authProviders/azureTokenCredentials";
@@ -23,7 +25,18 @@ const getCredential = (): AzureCliCredential => {
   return cachedCredential;
 };
 
+const execAsync = promisify(exec);
+
+const checkAzureCliInstalled = async (): Promise<void> => {
+  try {
+    await execAsync("az --version");
+  } catch (error) {
+    throw new Error("Azure CLI is not installed or not in PATH. Please install it to use this tool.");
+  }
+};
+
 export const authenticate = async (): Promise<AuthContext> => {
+  await checkAzureCliInstalled();
   startSpinner("Authenticating with Azure CLI...");
 
   try {

package/src/index.ts

@@ -5,7 +5,6 @@ import inquirer from "inquirer";
 import { name as npmPackageName, version } from "../package.json";
 import { authenticate } from "./auth";
 import { activateOnce, deactivateOnce, showMainMenu } from "./cli";
-import { runPresetAddWizard, runPresetEditWizard } from "./presets-cli";
 import {
   expandTemplate,
   getDefaultPresetsFilePath,
@@ -13,12 +12,13 @@ import {
   listPresetNames,
   loadPresets,
   removePreset,
-  savePresets,
   resolveActivatePresetOptions,
   resolveDeactivatePresetOptions,
+  savePresets,
   setDefaultPresetName,
   upsertPreset,
 } from "./presets";
+import { runPresetAddWizard, runPresetEditWizard } from "./presets-cli";
 import { configureUi, logBlank, logDim, logError, logInfo, logSuccess, logWarning, showHeader } from "./ui";
 import { checkForUpdate } from "./update-check";
 
@@ -98,7 +98,7 @@ const resolveValue = <T>(command: Command, optionName: string, cliValue: T, pres
 
 const program = new Command();
 
-program.name("azp-cli").description("Azure PIM CLI - A CLI tool for Azure Privilege Identity Management (PIM)").version(version);
+program.name("azp").description("Azure PIM CLI - A CLI tool for Azure Privilege Identity Management (PIM)").version(version);
 
 program
   .command("activate", { isDefault: true })
@@ -153,8 +153,7 @@ program
       const hasSubscriptionFromCli = getOptionValueSource(command, "subscriptionId") === "cli";
 
       const defaultPresetName = presets.data.defaults?.activatePreset;
-      const shouldUseDefaultPreset =
-        !explicitPresetName && Boolean(defaultPresetName) && (!hasSubscriptionFromCli || !hasRoleNamesFromCli);
+      const shouldUseDefaultPreset = !explicitPresetName && Boolean(defaultPresetName) && (!hasSubscriptionFromCli || !hasRoleNamesFromCli);
 
       const presetNameToUse = explicitPresetName ?? (shouldUseDefaultPreset ? defaultPresetName : undefined);
 
@@ -349,9 +348,9 @@ program
   });
 
 program
-  .command("update")
+  .command("check-update")
   .description("Check if a newer azp-cli version is available")
-  .alias("upgrade")
+  .alias("update")
   .option("--check-only", "Only check and print status (no upgrade instructions)")
   .option("--output <text|json>", "Output format", "text")
   .option("--quiet", "Suppress non-essential output (recommended with --output json)")
@@ -525,9 +524,7 @@ presetCommand
       const entry = getPreset(loaded.data, name);
       if (!entry) {
         const names = listPresetNames(loaded.data);
-        throw new Error(
-          `Preset not found: "${name}". Presets file: ${loaded.filePath}. Available: ${names.length ? names.join(", ") : "(none)"}`
-        );
+        throw new Error(`Preset not found: "${name}". Presets file: ${loaded.filePath}. Available: ${names.length ? names.join(", ") : "(none)"}`);
       }
 
       if (output === "json") {

package/src/ui.ts

@@ -223,7 +223,7 @@ export const showHeader = (): void => {
 
   console.log(chalk.cyan(top));
   printLine();
-  printLine(title, 2);
+  printLine(title, 4);
   printLine();
   printLine(tagline);
   printLine();