Skip to content

auth

Manage the GitHub Personal Access Token used by deploy and workflow commands.

Usage

subscribed auth login    # save a GitHub token
subscribed auth status   # show who you're authenticated as
subscribed auth logout   # remove the stored token

Setup

  1. Create a token at github.com/settings/tokens/new with these scopes:
  2. repo — read repository data (branches, workflows)

  3. workflow — trigger workflow_dispatch events

  4. Run: 

    subscribed auth login
    Paste your token when prompted. It is validated against the GitHub API before saving.

Storage

The token is stored at ~/.config/subscribed-cli/auth.json with file permissions 0600 (owner read/write only).