Octocopy

GitHub App

Install the Octocopy GitHub App

Installing the GitHub App is the fastest way to let Octocopy issue its own tokens. Follow these steps if you administer an organization or need the app on a personal account.

  1. 1

    Open the Octocopy GitHub App page and click “Install”. If you are already signed in, GitHub will ask whether to continue with your user account or switch to an organization.

  2. 2

    Pick the organization or user account that should authorize Octocopy. You will need admin permissions for that account.

  3. 3

    Choose which repositories Octocopy may access. Select “Only select repositories” to keep the app scoped to the repos you intend to copy.

  4. 4

    Review the permissions summary and confirm the installation. GitHub will provision an installation ID that Octocopy uses to request short-lived tokens.

Repository access tips

  • Create a dedicated “template” repository that Octocopy can read from if you do not want to expose production repos.
  • Grant access to both the source and destination repositories when Octocopy needs to copy labels, milestones, or issues between them.

After installation

  • Share the installation ID with teammates running the Octocopy CLI or extension (you can find it at Settings → GitHub Apps → Octocopy → About).
  • Rotate access periodically or uninstall the app when the project wraps up; you can always reinstall later.