{"id":17332567,"url":"https://github.com/profclems/clemsbot-github","last_synced_at":"2026-03-19T00:51:59.915Z","repository":{"id":110424825,"uuid":"312809335","full_name":"profclems/clemsbot-github","owner":"profclems","description":"A repo for my GitHub Bot @clemsbot","archived":false,"fork":false,"pushed_at":"2020-11-14T16:26:19.000Z","size":11,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-01T11:32:28.203Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","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/profclems.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}},"created_at":"2020-11-14T12:07:58.000Z","updated_at":"2023-08-05T11:44:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"e4c4f242-4081-4a3a-9e49-2f8c426ff70c","html_url":"https://github.com/profclems/clemsbot-github","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/profclems%2Fclemsbot-github","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profclems%2Fclemsbot-github/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profclems%2Fclemsbot-github/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profclems%2Fclemsbot-github/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/profclems","download_url":"https://codeload.github.com/profclems/clemsbot-github/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245793652,"owners_count":20673031,"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-15T14:58:09.432Z","updated_at":"2026-01-06T12:49:10.160Z","avatar_url":"https://github.com/profclems.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clemsbot-github\nA repo for my GitHub Bot @clemsbot\n\n\n## How to use the **@clemsbot** instance ##\n\n### As a GitHub App\n\nNotes:\n\n- Installation as a GitHub App is still in an experimental stage\nand you may frequently receive requests to expand permissions.\n\n- All the repositories that use the bot and belong to the same\nowner must install the bot using the same method (GitHub App or\nregular user).\n\n- If you were previously using the legacy installation method,\nmake sure you disable any previously set up GitHub webhooks when\nswitching to the GitHub App, otherwise the bot will receive every\nrequest twice.\n\nThe bot can be installed as a GitHub App to either your account or\norganization ([link to app](https://github.com/apps/clemsbot-github)).\nOnce you finish the installation, follow these steps:\n\n- Create a repository on GitLab.com which will be used to run CI jobs.\n\n  The bot will only take care of mirroring the PRs and reporting\n  status checks back so you may still want to activate the mirroring\n  feature for the main branches.  To do so, the easiest way is to\n  choose the \"CI/CD for external repo\" option when creating the GitLab\n  repository.  However, you should opt to give the repo by URL rather\n  than with the GitHub button, because we won't need GitLab's own\n  status check reporting feature. (If it is already activated, you can\n  disable this integration in the \"Settings\" / \"Integration\" menu).\n\n- In your GitLab repository:\n\n  - go to \"Members\" to add\n    [**@clemsbot**](https://gitlab.com/clemsbot) as a project member with\n    \"Developer\" role (so that it can push new branches).\n\n  - go to \"Settings\" / \"Webhooks\" and create one webhook that will be\n    triggered by pipeline events and job events. Set its URL to\n    \u003chttps://clemsbot.herokuapp.com/gitlab\u003e.\n\n  By default, **@clemsbot** considers that both GitHub and GitLab repositories\n  share the same URL except for the \"lab\" replacing the \"hub\" part. If\n  that is not the case, assuming you created a GitLab repository whose\n  URL is \u003chttps://gitlab.com/owner/repo/\u003e, add a file `clemsbot.toml` at\n  the root of your GitHub repository and in its default branch (most often\n  named `master`), containing:\n  ```\n  [mapping]\n  gitlab = \"owner/repo\"\n  ```\n  If you use other instance of **@clemsbot**, this repository-specific\n  configuration file becomes `BOT_NAME.toml` where `BOT_NAME` is the name\n  of the bot.\n\n### As a regular user account (legacy)\n\nThe bot used to be given access to each of your GitHub repositories as a\nregular GitHub user account (**@clemsbot**). This installation method is\nstill supported for repositories that haven't migrated to the GitHub App\nyet. Here are the steps to follow in addition to those described in the \n`As GitHub App` section:\n\n- In your GitHub repository:\n\n  - go to \"Settings\" / \"Manage access\" to add\n    [**@clemsbot**](https://github.com/clemsbot) as a collaborator with\n    the \"Write\" role (so that it can push status checks, and set\n    labels).\n\n    Currently, every invitation requires a manual validation, so there\n    may be some lag before **@clemsbot** can push status checks\n    to your repository.\n\n  - go to \"Settings\" / \"Webhooks\" and add one webhook with URL\n    \u003chttps://clemsbot.herokuapp.com/github\u003e that will only be triggered\n    at least by pull request events, and if you want to use the issue\n    milestone feature, by issue events as well.  Make sure you change\n    the \"content/type\" value to \"application/json\".\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofclems%2Fclemsbot-github","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprofclems%2Fclemsbot-github","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofclems%2Fclemsbot-github/lists"}