Skip to content

Ci bot

ci-bot

Manage CI template setup and token distribution for GitHub repositories.

ci-bot can apply/update Copier-based CI templates, store token files, refresh GitHub secrets, and track repository settings in a local JSON registry.

The registry defaults to ~/.config/ci_bot/repos.json; token files default to ~/.config/tokens/<name>.token.

Usage

ci-bot --help

Commands

  • setup: Apply template, set secret, and register a repository
  • update: Run template updates for a registered repository
  • token: Add/list/show local CI token files and refresh GitHub secrets
  • repo: List/add/remove/rename repos and set per-repo secret tokens
  • org token: Set an organization-level secret for selected repositories

For example, after an owner transfer, update the local registry and reapply the repository secret with:

ci-bot repo rename old-owner/repo new-owner/repo
ci-bot repo token --repo new-owner/repo --token-name ci_bot

repo rename updates the local registry only; it does not transfer the GitHub repository or change its Actions secret.