{"id":22261345,"url":"https://github.com/refactorsaurusrex/agile-cli","last_synced_at":"2026-05-03T19:33:59.349Z","repository":{"id":80975575,"uuid":"295618971","full_name":"refactorsaurusrex/agile-cli","owner":"refactorsaurusrex","description":"Generate agile metrics for your team's Jira project right from the command line!","archived":false,"fork":false,"pushed_at":"2022-04-19T13:40:56.000Z","size":85,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-30T12:28:03.396Z","etag":null,"topics":["agile","cli","cross-platform","jira","powershell"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/refactorsaurusrex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-15T04:58:37.000Z","updated_at":"2020-10-13T19:09:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9cd95a2-8027-4da9-90d8-6faf2b2040a2","html_url":"https://github.com/refactorsaurusrex/agile-cli","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refactorsaurusrex%2Fagile-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refactorsaurusrex%2Fagile-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refactorsaurusrex%2Fagile-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refactorsaurusrex%2Fagile-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/refactorsaurusrex","download_url":"https://codeload.github.com/refactorsaurusrex/agile-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245472462,"owners_count":20621112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agile","cli","cross-platform","jira","powershell"],"created_at":"2024-12-03T09:12:30.949Z","updated_at":"2026-05-03T19:33:54.306Z","avatar_url":"https://github.com/refactorsaurusrex.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AgileCli\n\nAgileCli is a command line tool for generating Agile metrics from Jira data, including:\n\n- Average velocity\n- *Average number* of committed, rolled over, and unplanned story points\n- Percent of sprints where the number of points completed were within an acceptable margin of error \n- *Absolute number* of points committed, completed, rolled over, and unplanned each sprint\n\nUnlike Jira's web-based reports, AgileCli allows further manipulation of all this data via any standard PowerShell function. If you really want to go crazy, you can easily export the data to a CSV, open it in Excel, and go to town!\n\n## Getting Started\n\n### System Requirements\n\nAgileCli is cross-platform and will work on Windows, Mac, and Linux. The only hard requirement is [PowerShell](https://github.com/PowerShell/PowerShell/releases/latest) 6 or later. \n\n### Installation\n\nInstall from the [PowerShell Gallery](https://www.powershellgallery.com/packages/AgileCli):\n\n```powershell\nInstall-Module AgileCli\n```\n\nOnce it's installed, the module will load automatically whenever a new PowerShell instance is created. To load it immediately after installation without creating a new instance, just run `Import-Module AgileCli`. \n\n### Initial Setup\n\nBefore you can use AgileCli, there's some initial setup that must be done:\n\n1. Log into your Jira account and generate an [API token](https://id.atlassian.com/manage-profile/security/api-tokens). \n2. Run `Save-JiraToken` and follow the prompts. This will securely store your API token on your local machine. Note that you cannot use keyboard shortcuts to paste your token. Instead, right click to paste. (PowerShell is awesome, but it's not perfect, and this is one of its more annoying limitations.)\n3. Run `Edit-AgileCliConfiguration`. This will load your AgileCli configuration file in your default yaml file editor. Enter your Jira instance's hostname where indicated. Do not include \"https://\". Instead, use the format \"my-company.atlassian.net\". Save the file and close. (For more information on the other configuration settings, see [this](https://github.com/refactorsaurusrex/agile-cli/wiki/Edit-AgileCliConfiguration).)\n4. Now you're ready for action! Read on...\n\n### A Quick Overview\n\n\u003e For more details on each AgileCli cmdlet, check out [the wiki](https://github.com/refactorsaurusrex/agile-cli/wiki). \n\nThe first thing you'll need is the name of the Jira board you want to use for data. Run `Get-JiraBoards` to get a list of all available boards. You can filter them by running something like `Get-JiraBoards | ?{$_.Name -like \"*MyBoard*\"}`. Now that you have your board name, you can start running reports.  Here are some examples:\n\n#### Sprint History\n\n```powershell\nPS\u003e Get-SprintHistory -BoardName \"Team Awesome\" | ft\n\nName                           Ended                 Committed Unplanned Completed Rollover PercentRollover\n----                           -----                 --------- --------- --------- -------- ---------------\nWhite Sands Walrus             9/15/2020 11:08:46 AM        33         0        24        9             27%\nVoyageurs Vampire Squid        9/1/2020 10:48:45 AM         31         0        28        3             10%\nUwharrie Unicornfish           8/18/2020 11:09:08 AM        38         1        21       17             45%\nTheodore Roosevelt Tiger Shark 8/4/2020 9:58:11 AM          45         8        29       16             36%\nShenandoah SarcasticFringehead 7/21/2020 11:02:00 AM        33         0        30        3             9%\n```\n\n#### Project Velocity\n\n```powershell\nPS\u003e Get-ProjectVelocity -BoardName \"Team Awesome\"\n\nAverageCommitted AverageCompleted AverageRollover AverageUnplanned\n---------------- ---------------- --------------- ----------------\n              35               27               8                2\n```\n\n#### Percent On Target Sprints\n\n````powershell\nPS\u003e Get-PercentOnTargetSprints -BoardName \"Team Awesome\"\n30%\n````\n\n#### Individual Metrics\n\n```powershell\nPS\u003e Get-UserPointAverages | ft\n\nAssignee       AverageCommitted AverageCompleted AverageRollover RolloverPercent\n--------       ---------------- ---------------- --------------- ---------------\nHomer          8.8              4.2              4.6             52%\nMarge          8.0              7.6              0.4             5%\nLisa           0.8              0.2              0.6             75%\nBart           0.8              0.6              0.2             25%\nMaggy          8.6              4.8              3.8             44%\nKrusty         9.0              9.0              0.0             0%\n```\n\n**Hint:** To sort these metrics by rollover percent, do this:\n\n```powershell\nGet-UserPointAverages -Raw | sort RolloverPercent -Descending | Format-UserPointAverages | ft\n```\n\n#### Get Jira Issues\n\n```powershell\nPS\u003e Get-JiraIssues -Type Rollover -Assignee \"Home\" | ft\n\nName                           Issue     Assignee     Points Unplanned Completed\n----                           -----     --------     ------ --------- ---------\nWhite Sands Walrus             TEAM-3657 Homer             3     False     False\nUwharrie Unicornfish           TEAM-3069 Homer             8     False     False\nTheodore Roosevelt Tiger Shark TEAM-3069 Homer             8      True     False\n```\n\n#### Open Jira Issues\n\n```powershell\nOpen-JiraIssue 'TEAM-3657'\n# (Opens your default browser and navigates to issue TEAM-3657)\n```\n\n#### List All Available Commands\n\n\u003e A complete listing is also on the [wiki home page](https://github.com/refactorsaurusrex/agile-cli/wiki#table-of-contents).\n\n```powershell\nGet-Command -Module AgileCli\n```\n\n### Configurations\n\n#### Default Board Name\n\nYou can set a default board name, so you don't have to type the `-BoardName` parameter every single time. To set the default, run `Edit-AgileCliConfiguration` and enter the default board name where indicated. You can always override the default by using the `-BoardName` parameter.\n\n#### Default Number of Sprints\n\nThe default number of sprints included in each command is **5**. You can set this to any integer value you want... as long as it's between 1 and 50. ;) You can always override the default by using the `-SprintCount` parameter.\n\n#### Sprint Commitment Margin of Error\n\nThe `Get-PercentOnTargetSprints` cmdlet relies on a setting called `SprintTargetPercent`. This is the maximum allowable variance between sprint commitment and completion in order to still be considered \"on target\". The default target is 15%, meaning as long as the completed number of points in each sprint is within +/-15% of the commitment, the team is still considered on target. You can change this target to any value between 1 and 100 by running `Edit-AgileCliConfiguration`.\n\n#### Jira Host Name\n\nThe host name for your Jira instance, as already noted above. \n\n## Help\n\n1. Run `help \u003ccmdlet_name\u003e ` to view help documentation in your terminal window. Example: `help Get-JiraBoards`.\n2. Read the [wiki documentation](https://github.com/refactorsaurusrex/agile-cli/wiki). \n3. If all else fails, [open an issue](https://github.com/refactorsaurusrex/agile-cli/issues). \n\n## Contributions\n\nContributions are welcome! If you have an idea, [open an issue](https://github.com/refactorsaurusrex/agile-cli/issues) and let's talk about it. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefactorsaurusrex%2Fagile-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frefactorsaurusrex%2Fagile-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefactorsaurusrex%2Fagile-cli/lists"}