{"id":15046163,"url":"https://github.com/takanome-dev/assign-issue-action","last_synced_at":"2025-10-26T07:31:15.997Z","repository":{"id":37056398,"uuid":"495135480","full_name":"takanome-dev/assign-issue-action","owner":"takanome-dev","description":"🤖 A Github action that simplifies issue management for maintainers and contributors, making collaboration more efficient","archived":false,"fork":false,"pushed_at":"2024-10-29T17:43:23.000Z","size":1725,"stargazers_count":8,"open_issues_count":18,"forks_count":1,"subscribers_count":2,"default_branch":"beta","last_synced_at":"2024-10-29T19:00:27.472Z","etag":null,"topics":["actions","gh-actions","github","github-actions","slash-commands","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/takanome-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-22T17:54:15.000Z","updated_at":"2024-10-21T21:18:32.000Z","dependencies_parsed_at":"2024-03-17T21:47:01.059Z","dependency_job_id":"cfbd66fe-e1df-4fe3-b435-f79b4511ef21","html_url":"https://github.com/takanome-dev/assign-issue-action","commit_stats":{"total_commits":241,"total_committers":6,"mean_commits":"40.166666666666664","dds":0.3319502074688797,"last_synced_commit":"54dd171534b157f01c9103f5076a110c23bccf66"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanome-dev%2Fassign-issue-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanome-dev%2Fassign-issue-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanome-dev%2Fassign-issue-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanome-dev%2Fassign-issue-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/takanome-dev","download_url":"https://codeload.github.com/takanome-dev/assign-issue-action/tar.gz/refs/heads/beta","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238284816,"owners_count":19446734,"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":["actions","gh-actions","github","github-actions","slash-commands","typescript"],"created_at":"2024-09-24T20:52:47.752Z","updated_at":"2025-10-26T07:31:15.991Z","avatar_url":"https://github.com/takanome-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003e💬 Assign Issue Action ✋\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/TAKANOME-DEV/assign-to-me-action\"\u003e\u003cimg alt=\"Licence Badge\" src=\"https://img.shields.io/github/license/TAKANOME-DEV/assign-to-me-action?color=%2330C151\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/TAKANOME-DEV/assign-to-me-action\"\u003e\u003cimg alt=\"Release Badge\" src=\"https://img.shields.io/github/release/TAKANOME-DEV/assign-to-me-action?color=%2330C151\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/TAKANOME-DEV/assign-to-me-action\"\u003e\u003cimg alt=\"GitHub Actions status\" src=\"https://github.com/TAKANOME-DEV/assign-to-me-action/actions/workflows/development.yml/badge.svg\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/TAKANOME-DEV/assign-to-me-action\"\u003e\u003cimg alt=\"GitHub Actions status\" src=\"https://github.com/TAKANOME-DEV/assign-to-me-action/actions/workflows/codeql-analysis.yml/badge.svg\"\u003e\u003c/a\u003e \u003ca href=\"https://codecov.io/gh/TAKANOME-DEV/assign-to-me-action\"\u003e\u003cimg src=\"https://codecov.io/gh/TAKANOME-DEV/assign-to-me-action/branch/master/graph/badge.svg?token=MX3SB0GFB3\" /\u003e\u003c/a\u003e\u003c/p\u003e\n\n---\n\nThis action simplifies issue management for maintainers and contributors, making collaboration more efficient.\nSee the list of [features](#features) below for more details.\n\n## Features\n\n- 📝 Self-assign issues using `/assign-me` command (default)\n- 🗑️ Self-unassign from issues using `/unassign-me` command (default)\n- 👥 Maintainer-controlled assignments using `/assign @\u003cuser\u003e` and `/unassign \u003c@user\u003e` commands\n- ⏰ Automatic unassignment of inactive issues after configurable period (default: 7 days)\n- 🛡️ Block self-reassignment after unassignment (requires maintainer approval)\n- 🔔 Send reminder notifications before automatic unassignment occurs\n- 🔢 Limit the maximum number of issues a user can be assigned to simultaneously (default: 3)\n\n## 💻 Usage\n\nCreate a workflow (eg: `.github/workflows/assign.yml` learn more about [Creating a Workflow file](https://docs.github.com/en/actions/using-workflows#creating-a-workflow-file)):\n\n```yaml\nname: Assign Issue\n\non:\n schedule:\n - cron: 0 0 * * *\n issue_comment:\n types: [created]\n workflow_dispatch:\n\njobs:\n assign:\n permissions:\n issues: write\n runs-on: ubuntu-latest\n steps:\n - name: Assign the user or unassign stale assignments\n uses: takanome-dev/assign-issue-action@beta\n with:\n github_token: ${{ secrets.GITHUB_TOKEN }}\n maintainers: '' # list of maintainers with comma separated like 'takanome-dev,octocat'\n # learn more about the inputs below ⬇\n```\n\n## Inputs\n\nVarious inputs are defined in action.yml to let you configure the action:\n\n| Name | Description | Default |\n| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |\n| `github_token` | PAT for GitHub API authentication. It's automatically generated when the action is running, so no need to add it into your secrets. | `${{ github.token }}` |\n| `self_assign_cmd` | The command that assigns the issue to the one who triggered it | `/assign-me` |\n| `self_unassign_cmd` | The command that unassigns the issue from the user who triggered it, if they are already assigned. | `/unassign-me` |\n| `assign_user_cmd` | The command that assigns the user to the issue | `/assign @\u003cuser\u003e` |\n| `unassign_user_cmd` | The command that unassigns the user from the issue, if they are assigned. | `/unassign @\u003cuser\u003e` |\n| `maintainers` | A list of maintainers authorized to use `/assign` and `/unassign` commands. List the usernames with comma separated (i.e: 'takanome-dev,octokit'). If not set, the usage of those commands will be ignored. | `''` |\n| `enable_auto_suggestion` | A boolean input that controls whether the action should automatically check user comments for phrases signaling interest in issue assignment. Set to true by default. | **`true`** |\n| `assigned_label` | A label that is added to issues when they're assigned, to track which issues were assigned by this action. | `📍 Assigned` |\n| `required_label` | If set, the issue must have this label to be assigned. | `''` |\n| `days_until_unassign` | The span of time between a user assigning themselves to the issue being unassigned automatically by the action. | `7` |\n| `pin_label` | A label that prevents the user from being unassigned, typically for issues that are expected to take a long time. | `📌 Pinned` |\n| `assigned_comment` | The comment posted after a user has assigned themselves to an issue. | Customizable |\n| `already_assigned_comment` | The comment posted when a user tries to assign themselves to an issue that is already assigned | Customizable in the workflow file you're going to create. |\n| `already_assigned_comment_pinned` | The comment posted when a user tries to assign themselves to a pinned issue that is already assigned | Customizable message for pinned issues that won't be auto-unassigned. |\n| `unassigned_comment` | The comment posted after a user is unassigned from an issue. | Customizable in the workflow file you're going to create. |\n| `assignment_suggestion_comment` | The comment posted when someone shows interest in being assigned to an issue without using the assignment commands. | Customizable in the workflow file you're going to create. |\n| `block_assignment` | Whether to block self-assignment after a user was previously unassigned. | `true` |\n| `block_assignment_comment` | The comment posted when a user tries to re-assign themselves after being unassigned. | Customizable message explaining that a maintainer needs to approve reassignment. |\n| `enable_reminder` | Whether to send a reminder before automatic unassignment occurs. | `true` |\n| `reminder_days` | How many days before unassignment to send a reminder. Set to 'auto' to calculate halfway point (days_until_unassign / 2) | `auto` |\n| `reminder_comment` | The comment posted as a reminder before automatic unassignment. | Customizable message warning about upcoming unassignment. |\n| `max_assignments` | The maximum number of issues a user can be assigned to at once. | `3` |\n| `max_assignments_message` | The message posted when a user has reached their maximum assignments. | Customizable message explaining the limit and options for managing assignments. |\n\n## Outputs\n\nThe action provides the following outputs that can be used in subsequent workflow steps:\n\n| Name | Description |\n| ------------------- | -------------------------------------------------------------------------------- |\n| `assigned` | Returns 'yes' if an issue was successfully assigned, 'no' otherwise |\n| `unassigned` | Returns 'yes' if an issue was successfully unassigned, 'no' otherwise |\n| `unassigned_issues` | An array containing the issue numbers that were unassigned during the action run |\n\n## ✏️ Contributing\n\nWe would love you to contribute to this project, pull requests are welcome!\nPlease see the [CONTRIBUTING.md](CONTRIBUTING.md) for more information.\n\n## ⚖️ LICENSE\n\nThe scripts and documentation in this project are released under the [MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakanome-dev%2Fassign-issue-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftakanome-dev%2Fassign-issue-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakanome-dev%2Fassign-issue-action/lists"}