{"id":43939354,"url":"https://github.com/aloussase/squad-rotation-bot","last_synced_at":"2026-02-07T01:32:47.536Z","repository":{"id":321707628,"uuid":"1066573889","full_name":"aloussase/squad-rotation-bot","owner":"aloussase","description":"Bot to send messages to your chats to indicate who's turn is it to facilitate the daily rituals","archived":false,"fork":false,"pushed_at":"2025-10-31T03:15:12.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-31T05:23:43.922Z","etag":null,"topics":["bot","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","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/aloussase.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-29T17:09:01.000Z","updated_at":"2025-10-31T03:16:26.000Z","dependencies_parsed_at":"2025-10-31T05:23:48.999Z","dependency_job_id":"2d4055e9-8752-4206-a0be-bbc1c72f70b9","html_url":"https://github.com/aloussase/squad-rotation-bot","commit_stats":null,"previous_names":["aloussase/squad-rotation-bot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/aloussase/squad-rotation-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloussase%2Fsquad-rotation-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloussase%2Fsquad-rotation-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloussase%2Fsquad-rotation-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloussase%2Fsquad-rotation-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aloussase","download_url":"https://codeload.github.com/aloussase/squad-rotation-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloussase%2Fsquad-rotation-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29183977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T00:44:15.062Z","status":"ssl_error","status_checked_at":"2026-02-07T00:35:01.758Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bot","go","golang"],"created_at":"2026-02-07T01:32:47.471Z","updated_at":"2026-02-07T01:32:47.527Z","avatar_url":"https://github.com/aloussase.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Squad Rotation Bot\n\nThis is a bot that you can integrate into your gchat spaces to send a message\nto indicate who's turn is it to facilitate the daily.\n\n## Pre-requisites\n\nThis is an application that runs periodically on a scheduled time, so you will\nneed to have some server where to run it.\n\nI personally run my instance on one of my Raspberries, but any hosted server\nshould work as well. I can recommend [Hetzner](https://www.hetzner.com/).\n\n## Configuring\n\nMake sure to configure the following according to your needs:\n\n- **The time at which to run the bot** is configured in `scripts/crontab`.\n  Follow the indications in that file.\n- **Set the webhook URL** by setting the `WEB_HOOK_URL` environment variable to\n  the value of the gchat webhook URL. You can generate this in the integrations\n  settings tab of your gchat space.\n- **Optionally configure the database connection details** by setting the\n  environment variables used in the compose file\n\n## Usage\n\n### With docker-compose\n\n1. Clone this repository:\n\n```shell\ngit clone https://github.com/aloussase/squad-rotation-bot\ncd squad-rotation-bot\n```\n\n2. Run the services:\n\n```shell\nexport WEB_HOOK_URL='...'\ndocker compose up -d\n```\n\n## Managing squad members\n\nYou basically have 3 options for managing squad members.\n\n### 1. Edit the `databse/init.sql` file\n\nYou can edit the database initialization script and add `INSERT` statements to\ninsert your squad members.\n\n### 2. Exec into the Postgres container\n\nYou can also exec into the running Postgres container to use `psql` to `INSERT` the\nsquad members:\n\n```shell\ndocker compose exec db psql -U postgres\n```\n\nThat command will start a `psql` console where you can issue your database commands.\n\nMake sure to replace `postgres` by whatever value you've configured as the\ndatabase user, if any. `postgres` is the default one.\n\n### 3. Use the provided CLI\n\nThere is a Docker image that packages a CLI tool to manage your squad members.\nYou can run it with the following command:\n\n```shell\ndocker run -it --network host aloussase69/squad-rotation-bot-cli\n```\n\n![Squad Rotation Bot CLI Demo](./assets/cli_demo.gif)\n\n## Contributing\n\nContributing ideas:\n\n- More messaging backends (e.g.: discord, slack, carrier pigeon; etc)\n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faloussase%2Fsquad-rotation-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faloussase%2Fsquad-rotation-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faloussase%2Fsquad-rotation-bot/lists"}