Home
azdw is a cross-tenant work-item and portfolio intelligence tool for Azure DevOps and GitHub. It brings work items together across organizations, projects, repositories, and Entra ID tenants, then makes their queries, relationships, reports, and visualizations available through the CLI, MCP server, REST API, and .NET library.
This documentation covers installation, authentication, configuration, cross-organization querying, relationship resolution, portfolio ranking, reporting, visualization, AI-assisted workflows, and extension points. The deterministic query and reporting features work independently of AI, while MCP and the AI features provide optional integrations for supported assistants and providers.
Start Here
New to azdw? Begin with Getting Started, then review Authentication Types and Azure DevOps Permissions before connecting real organizations. For automation and integrations, continue with AI Features Overview, MCP Server Setup, or API Documentation.
Guides
- Getting Started
- Authentication Types
- Token Expiration Guide
- Azure DevOps Permissions
- Configuration Discovery
- CLI Use Cases
- CLI Help Overview
- Shell Completions
Queries, Relationships, and Reports
- Filtering Query Results
- Batch Work Item Operations
- Cross-Organization Relationship Handling
- Relationship Commands
- Work Item Type Mapping
- Custom Node Fields
- Output Rendering Automation
- Global Stack Rank
- Explore JSON Data
Integration and Extension
- API Documentation
- MCP Server Setup
- MCP OAuth Entra ID Setup
- AI Features Overview
- Prompt Files
- Workspace Context and AI Discovery
- Plugin Development Guide
Operations
For security and privacy responsibilities, see the repository-level SECURITY.md.