{"id":15662438,"url":"https://github.com/wei/discord-actions-bot","last_synced_at":"2025-07-01T09:05:52.371Z","repository":{"id":83391414,"uuid":"440227412","full_name":"wei/discord-actions-bot","owner":"wei","description":"🤖 A Discord Bot that helps with Action Items.","archived":false,"fork":false,"pushed_at":"2022-12-03T14:31:47.000Z","size":74,"stargazers_count":18,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-05T23:48:18.987Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/wei.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":"2021-12-20T15:59:28.000Z","updated_at":"2024-03-27T14:07:12.000Z","dependencies_parsed_at":"2023-03-12T18:13:31.047Z","dependency_job_id":null,"html_url":"https://github.com/wei/discord-actions-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wei/discord-actions-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wei%2Fdiscord-actions-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wei%2Fdiscord-actions-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wei%2Fdiscord-actions-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wei%2Fdiscord-actions-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wei","download_url":"https://codeload.github.com/wei/discord-actions-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wei%2Fdiscord-actions-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262933262,"owners_count":23386778,"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":"2024-10-03T13:32:36.771Z","updated_at":"2025-07-01T09:05:52.350Z","avatar_url":"https://github.com/wei.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![discord-actions-bot](https://socialify.git.ci/wei/discord-actions-bot/image?description=1\u0026font=Bitter\u0026logo=https%3A%2F%2Fuser-images.githubusercontent.com%2F5880908%2F205446002-9245a89e-9927-49cd-91dc-bea8bd079336.svg\u0026name=1\u0026pattern=Plus\u0026theme=Dark)\n\n\n## Installation\n\nInstall the [**Actions Bot**](https://discord.com/oauth2/authorize?client_id=922524247274950666\u0026scope=bot%20applications.commands\u0026permissions=446677109824).\n\n\n## Usage\n\n### `/action-react`\n\nCreate an action that requires users of a particular role to react with a ✅.\n\nFollow the slash command prompt:\n```\n/action-react [role] [message]\n```\n\nExample:\n```\n/action-react @Pod 4.0.3 Due Friday: Complete Week 12 Survey\n```\n\n![](https://user-images.githubusercontent.com/5880908/146950481-f6fa4469-c4cf-4f4c-910f-a566bbb233ff.png)\n![](https://user-images.githubusercontent.com/5880908/146950525-846cfc2d-6029-4fed-9365-d91c05bb45e8.png)\n![](https://user-images.githubusercontent.com/5880908/146950581-b3c55d8a-0939-4a44-88c3-098337b56fde.png)\n\n### `/action-thread`\n\nCreate an action that requires users of a particular role to reply in a thread.\n\nFollow the slash command prompt:\n```\n/action-thread [role] [message]\n```\n\nExample:\n```\n/action-thread @Pod 4.0.3 Friday December 17th: Post Standup Notes\n\n/action-thread @Pod 4.0.3 Week 12 Retrospective\n```\n\n![](https://user-images.githubusercontent.com/5880908/146950775-a636f346-2d8b-424f-9e35-78bb2600244d.png)\n![](https://user-images.githubusercontent.com/5880908/146950866-e93a23fc-d5f9-4bec-8fc2-de2ad4aefdd3.png)\n\n### `/action-poll`\n\nCreate a poll that requires users of a particular role to vote by reacting.\n\nFollow the slash command prompt:\n```\n/action-poll [role] [title] [options]\n```\n\nExample:\n```\n/action-poll @Pod 4.0.3 [What do you want to play at our game day?] [Skribbl, Gartic Phone, Among Us, Jack Box]\n```\n\n![](https://user-images.githubusercontent.com/5880908/150705373-3eaf06c8-964c-4322-8d58-209395f05c5a.png)\n![](https://user-images.githubusercontent.com/5880908/150705282-b4492523-77b5-4afb-8487-5f52f9f63dc6.png)\n![](https://user-images.githubusercontent.com/5880908/150705327-1bb1fee6-40a2-4477-9e08-e871ee2d1ab5.png)\n\n\n## Self-hosting\n\n### Step 1: Create and Install Discord App\n\n1. Create a new [Discord app](https://discord.com/developers/applications).\n1. Go to the app's dashboard and create a bot user with _SERVER MEMBERS INTENT_ turned on.\n1. Install the **Discord Bot** by going to `https://discord.com/oauth2/authorize?client_id=${CLIENT_ID}\u0026scope=bot%20applications.commands\u0026permissions=446677109824`\n\n### Step 2: Deployment\n\nFirst, `cp .env.example .env` and fill in the required fields.\n\n#### Method 1: Node Deployment\n```bash\n# Register Discord slash commands, only need to run this once\nnpm run deploy-commands\n\n# Run the bot\nnpm start\n```\n\n#### Method 2: Docker Deployment\n\n```bash\ndocker build -t discord-actions-bot .\n\n# Register Discord slash commands, only need to run this once\ndocker run --rm --env-file .env \\\n  -v discord-actions-bot-db:/app/db \\\n  discord-actions-bot npm run deploy-commands\n\n# Run the bot\ndocker run --name discord-actions-bot --env-file .env \\\n  -v discord-actions-bot-db:/app/db \\\n  discord-actions-bot\n```\n\n\n## Journey\n\n### Idea\n\nAs a team that consists of a pod-leader and a fellow alumni, we decided to build an app that would make our lives easier.\n\nShifting from one platform to another to do simple everyday things like completing action items in Google Sheets and writing standup notes in GitHub Discussions was very tedious. So we decided to try and move those things to a platform of choice, Discord.\n\n### Implementation\n\nWe used [Discord.js](https://discord.js.org/#/), [Docker](https://www.docker.com/), and [Tenor API](https://tenor.com/gifapi/documentation).\n\nWith Discord.js, we were able to build the commands needed to serve the logic that the Action Bot follows. Such as deleting messages, updating lists, creating threads, and everything else has been done with Discord.js.\n\nWe also used Docker to create an image and serve the bot on a server. It should provide a seamless integration for anybody who would like to use the bot in their own Discord channels.\n\nAnd finally, to make completing the actions fun, we added a random GIF that will show up when an action is completed by all pod members.\n\n### Results\n\nIn the few hours we put toward this hackathon project, we built a stable product that will let fellows complete their tasks without leaving Discord. It will let us keep everything within one platform to allow for better navigation and performance.\n\n## Future Plans\n\n### `/action-remind` (remind asap) || `/action-set-reminder 3` (hours in advance)\n\nSend friendly reminders to fellows to complete their standup notes (no need for messages).\n\n### `/action-survey`\n\nAsk fellows for their feedback in a private thread to learn about their experiences in one platform (no third-party providers).\n\n### `/action-meet-fellows`\n\nMatch fellows for quick 1-1s where they can setup meetings in private threads.\n\n\n## Authors\n\n- [@dtemir](https://github.com/dtemir)\n- [@wei](https://github.com/wei)\n\n_Part of MLH Internal Hackathon 2021_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwei%2Fdiscord-actions-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwei%2Fdiscord-actions-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwei%2Fdiscord-actions-bot/lists"}