Tentaclo

Token guide

Tentaclo needs a classic GitHub token with the repo scope. It takes a couple of minutes. The app's interface is in Spanish, so its labels are shown here as they appear.

Create the token

  1. Open the GitHub form. The name and the repo checkbox are already filled in. Tentaclo has the same button in its settings.
  2. Under Expiration, choose 90 days or more.
  3. Click Generate token without changing the checkboxes.
  4. Copy the token. GitHub only shows it once.
  5. In Tentaclo, open the panel from the menu bar, click the gear icon, paste it under Token de GitHub and click Guardar (Save).

Treat the token like a password. Don't share it, not even with support.

Why a classic token

GitHub's notifications API only supports classic tokens. Tentaclo rejects tokens starting with github_pat_ so you don't run into errors later.

What the repo scope allows

It's a broad permission: read and write access to every repository you can access, including private ones. GitHub doesn't offer a narrower scope that covers this.

Tentaclo reads data to display it, and only writes to GitHub when you ask it to: marking a notification as read, confirming a workflow re-run, or creating a repository.

When it expires

Tentaclo warns you 7 days ahead, with a button to create another. If the token expires or loses its scope, the panel takes you to Settings to paste a new one.

Organizations with SSO

If your organization uses SAML SSO, you need to authorize the token for it from your GitHub token list, using Configure SSO.

Removing access

You can remove the token in Tentaclo's settings, and revoke it at any time from your GitHub token list.