How to create a GitHub API token with the narrowest permissions

Shipyard uses a GitHub token for code. The token is stored in your computer's keychain and is not sent to shipyardmcp.com. These are the exact steps, and the smallest set of permissions that works.

Create the token

Start here: https://github.com/settings/personal-access-tokens/new

  1. Open the link. The name and the permissions are already filled in.
  2. Resource owner: your account, or the organisation your projects live in.
  3. Expiration: pick "No expiration", or the longest option offered.
  4. Repository access: All repositories (the new repository does not exist yet, so it cannot be selected).
  5. Check that Permissions shows Administration and Contents, both "Read and write". Add them if the link did not.
  6. Press Generate token and copy it. GitHub shows it only once.

Permissions, and why each one is needed

Set up once in GitHub before your first launch

What stays manual

These are things only a person can do at this provider. Shipyard cannot and will not do them for you.

What you paste into Shipyard

Have this set up for you

Shipyard connects your accounts once and then does all of this for every new product, in about an hour.

See how it works

Related guides

How to create a GitHub API token with the narrowest permissions – Shipyard