{"id":24614449,"url":"https://github.com/tabuckner/jira-to-sheets","last_synced_at":"2026-05-19T02:03:25.032Z","repository":{"id":57280957,"uuid":"119866543","full_name":"tabuckner/jira-to-sheets","owner":"tabuckner","description":"Small NPM Package to handle a very specific need to pull data and upload to google sheets.","archived":false,"fork":false,"pushed_at":"2019-04-18T15:48:23.000Z","size":55,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-04-26T07:22:38.407Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/jira-to-sheets","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tabuckner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-01T17:03:27.000Z","updated_at":"2019-04-18T15:48:25.000Z","dependencies_parsed_at":"2022-09-06T01:00:24.810Z","dependency_job_id":null,"html_url":"https://github.com/tabuckner/jira-to-sheets","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabuckner%2Fjira-to-sheets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabuckner%2Fjira-to-sheets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabuckner%2Fjira-to-sheets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabuckner%2Fjira-to-sheets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tabuckner","download_url":"https://codeload.github.com/tabuckner/jira-to-sheets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244273411,"owners_count":20426923,"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":[],"created_at":"2025-01-24T21:16:55.629Z","updated_at":"2026-05-19T02:03:24.999Z","avatar_url":"https://github.com/tabuckner.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jira-To-Sheets\n\n_A very simple tool, for a very specific need._\n\nIntended to be installed as a CLI, this tool might help those of us who are interested in automating some of the boring work for preparing regular scrum demos/retrospective meetings. This was originally designed for use by members of my organization. If you don't see my ugly mug on a daily basis, Dan is not crushing it, and you should see [this section](#outside-of-our-organization) below.\n\nFor an explanation of the questions you will see in this CLI, please see [this section](#question-overview).\n\nThe tool uses Jira's authentication api to store a cookie locally and query your Jira organization for data regarding a given project's current sprint, and upcoming sprint. \n\nThe PlanITPoker report may be copied and pasted direclty into PlanITPoker if this helps you. If you have any feature requests or find any bugs ***PLEASE*** submit an [issue](#bugs-or-feature-requests) so I can work on them for you.\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine as a CLI.\nOne step configuration and a single End of Sprint `eos` command\n\n### Prerequisites\n\nWhat things you need to install the software and how to install them\n\n```\nnode and respective requirements (e.g. xcode, etc)\n```\n\n```\nGoogle Account for OAuth process\n```\n\n```\nGoogle Sheets spreadsheet.\n```\n\n### Installing\n\nAs a CLI:\n\nInstall globally via NPM\n\n```\n\u003csudo\u003e npm install -g jira-to-sheets\n```\n\n## After Installing\n\nYou can run the CLI from your terminal...\n\n### To Configure \n\nInitial run will be used to set up your OAuth credentials for subsequent uses\n\n```\n\u003csudo\u003e eos\n```\n\nAnswer yes at the first prompt and follow subsequent instructions\n\n```\n? Is this your first time using the tool? (Default: False) Y\n```\n\n### After Configured\n\nSubsequent executions\n\n```\n\u003csudo\u003e eos\n```\n\n### Outside of Our Organization\n**When you see this prompt:**\n```\n? Is Dan Crushing it?\n(Default: No) No\n```\n\nSimply answer the default no as shown above. This will remove any custom fields from the Jira query and help prevent errors or unwanted data.\n\n**When you see this prompt:**\n```\n? Jira Project Key (jql) CORE, TBN\n```\n\nSimply input the Jira Project Key(s) separated by commas (where applicable) as shown above. \n\n## Question Overview\n\n### Intial Run\n```\n? Is this your first time using the tool?\n(Default: No) (y/N)\n```\nIf yes, or if recently updated, you will be walked through an authentication process. Must restart tool after completed.\n\n### Organization Hotpath\n```\n? Is Dan Crushing it?\n(Default: No) (y/N)\n```\nLogic fork to make my buddie's lifes easier. If you dont work with me, answer no.\n\n### Jira Username\n```\n? Atlassian/Jira username:  \n```\nYour Jira Username, may be found at:\nhttps://yourdomain.atlassian.net/secure/ViewProfile.jspa\n\n### Jira Password\n```\n? Atlassian/Jira password:  \n```\nYour Jira Password, if you dont know it you can probably request it at:\n![alt tag](https://media.giphy.com/media/xT0GqlK9efNWRiKhQk/giphy.gif \"555 Come-On-Now\")\n\n### Action\n```\n? What opearation are you looking to run?\n(Default: Populate Blank Sheet(s)) (Use arrow keys)\n❯ Populate Blank Sheet(s)\n  Update Existing Sheet(s)\n```\nUpdate clears sheet prior to bringing in new data, Populate appends to whatever is existing (best used on a blank sheet).\n\n### Report Type(s)\n```\n? What reports?\n(Default: Both) (Use arrow keys)\n  Demo Sheet\n  PlanITPoker\n❯ Both\n```\nDemo Sheet example may be found [here](#demo-report)\nPlanITPoker example may be found [here](#planitpoker)\n\n### Jira Project(s)\n```\n? Select the Jira Project\n  RT\n  CORE\n  TBN\n  CORE \u0026 TBN\n❯ User Defined\n```\nFirst Three options are fast-tracks for my organization, please use User Defined if this doesn't make sense.\n\n### Project Key\n```\n? Jira Project Key (jql)\n```\nEnter your Jira Project Key(s) (likely unique to your organization), separated by columns where applicable.\n\n### Demo Sheet Name\n```\n? Name of Demo Sheet/Tab:\n(Default: Sheet1) (Sheet1)\n```\nEnter the name of the target sheet *Exactly As Shown* in Google Sheets.\n\n### PlanITPoker Target\n```\n? Name of PlanITPoker Sheet/Tab:\n(Default: Sheet2) (Sheet2)\n```\nEnter the name of the target sheet *Exactly As Shown* in Google Sheets.\n\n### Key Index\n```\n? Columns letters for Key Index (shared value):\n(Default: C) (C)\n```\nThe current column that houses the unique project key on your existing spreadsheet. This is used to link data between old and new data. \n\n## Exceptions\n```\n? Columns letters on Demo Sheet excluded from Update separated by columns:\n(Default: H, I) (H, I)\n```\nColumn(s) to be excluded from data overwrite and taken as 'more-accurate' on existing sheet. \n**Use Case: **\nQ: My organization has assigned a 'Will/Wont Demo' (Column H) column, and an associated 'Who?' Column (Column I) to delegate demos for the end of a sprint. As a user I would like to see this data preserved when udpating my spreadsheet with current Jira data. \nA: Use the default settings above.\n\n### Spreadsheet Target\n```\n? Google Sheets key or URL: \n```\nEnter either the full url or the unique google sheets id key in this field. Url is easier. Copy-Pasta.\n\n## Report Examples\n\n### Demo Report\n![alt tag](https://i.imgur.com/CLDkwRE.png \"Demo Report\")\n\n### PlanITPoker\n![alt tag](https://i.imgur.com/1POPcz5.png \"PlanITPoker\")\n\n## Bugs or Feature Requests\n\nPlease submit an Issue via [Github](https://github.com/tabuckner/jira-to-sheets/issues)\n\n## Contributing\n\nPlease submit a PR via [Github](https://github.com/tabuckner/jira-to-sheets/pulls)\n\n## Authors\n\n* **Taylor Buckner** - *Initial work* - [tabuckner](https://github.com/tabuckner)\n\n## License\n\nThis project is licensed under the MIT License\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftabuckner%2Fjira-to-sheets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftabuckner%2Fjira-to-sheets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftabuckner%2Fjira-to-sheets/lists"}