taskr

Tool (dotnet) to View Azure DevOps (or Jira) Tasks' details by States and other Fields

Pre-req: Install dotnet core 3.1 (if not already installed)
dotnet tool install -g --ignore-failed-sources taskr
> taskr

Type: Index / Work-item ID / Search term / Field: Search-term
Tab out: For auto-completion

Examples:

> field:<TAB> // For Auto-completion
> 2 // Index of the Account to fetch the Work-items for
> <ENTER> // Display all Work-items for the Account
> 5680 // ID of the Work-item to print the details for
> secure practices // Phrase to filter the Work-items (searches across all fields)
> tags=security // field-name and value to filter the Work-items (searches the specified field for the provided value)
> open 5680 // Opens the Work-item (ID: 5680) in the default browser
> cls // Clears the console
> quit // Quits the app
> + // Updates Taskr to latest version
> ? // Print Help

Settings: %USERPROFILE%\Documents\Taskr.json

(For relocated Documents folder: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders)

{
  "CheckUpdates": false, // Check for updates when Taskr is run
  // Defaults
  "Query": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = '{0}' AND [System.WorkItemType] = 'Task' ORDER BY [System.Id] ASC",
  "Slicers": "Tags,Priority,IterationPath",  
  "Exclusions": [ "MD_", "DT_", "MO_" ], // Any Slicer-values to be excluded. Can be overridden at each Account level too.
  "Accounts": [ // Azure DevOps Project details
    {
      "Name": "Account-1",
      "Org": "Org-1",
      "Project": "Project-1",
      "Token": "PAT Token for Org-1/Project-1",      
      "Slicers": "AssignedTo,Priority,IterationPath" // Override
      "Enabled": true
    },
    {
      "Name": "Account-2",
      "Type": "Jira", // For Jira projects
      "Org": "Org-2",
      "Project": "Project-2",
      "Token": "user@email.com:apiToken", // Basic-auth format
      "Query": "project={0} AND type=Subtask", // JQL query override
      "Enabled": true
    }
  ]
}

You can override the default Query and Slicers values at each Account level in Taskr.json

---

Contribution

Install Python (and Pip) for pre-commit hooks

pip install pre-commit

# Clone spex
git clone https://github.com/vamsitp/Taskr.git

# Important!!!
git config --global init.templateDir .git-template