v1.6.0

2 hours ago

A pull request opens on a repository that has not finished setting up the explainer. Before this release, the workflow turned red on that contributor's pull request. Now the run passes, and one note on the pull request says what is missing.

Ask about this presentation

Chapters

  1. 0:00A missing key no longer fails the check
  2. 0:15Setup step, not the contributor's fault
  3. 0:29The note on the pull request
  4. 0:49The secret name comes from your workflow
  5. 1:15Renamed Pull Request Explainer
  6. 1:33Watch reads repository channel links
  7. 1:53Green no longer proves the explainer ran
  8. 2:14Upgrade to v1.6.0
Show transcript

A missing key no longer fails the check

bisque-cloud/presenter · v1.6.0

No key set?
The check
stays green.

explainPassed · setup note posted
A note on the pull request says what is missing.

A pull request opens on a repository that has not finished setting up the explainer. Before this release, the workflow turned red on that contributor's pull request. Now the run passes, and one note on the pull request says what is missing.

Setup step, not the contributor's fault

bisque-cloud/presenter · v1.6.0

A missing key is a setup step, not the contributor's fault.

explainFailed · Set one provider key
explainPassed · setup note posted

Without a provider key, the action stopped with a plain message. Set one provider key. That showed up as a red check on a pull request, and the cause was the maintainer's setup. In this release the same run is green.

The note on the pull request

bisque-cloud/presenter · v1.6.0

One line names the secret, how to make it, and where to re-run.

No explainer yet: the CLAUDE_CODE_OAUTH_TOKEN secret is not set. A maintainer can run claude setup-token, save what it prints as CLAUDE_CODE_OAUTH_TOKEN under Settings → Secrets and variables → Actions, then re-run this job.
which secrethow to make itlink to re-run

The note is a single comment on the pull request. It says there is no explainer yet because the secret is not set. It tells a maintainer to run claude setup-token, save the result as that secret under the repository settings, then re-run the job. That covers which secret, how to make it, and a link to re-run.

The secret name comes from your workflow

bisque-cloud/presenter · v1.6.0

The note uses the secret name from your own workflow file.

# .github/workflows/explain.yml
with:
  xai-api-key: ${{ secrets.GROK_KEY }}
→
No explainer yet: the GROK_KEY secret is not set. A maintainer can save an xAI API key as GROK_KEY…
No key line in the file? The note uses CLAUDE_CODE_OAUTH_TOKEN.

The action reads the workflow file that started the run, and looks for the line that passes a secret to a key input. If that line hands a secret called GROK_KEY to the xAI input, the note names GROK_KEY, and says to save an xAI API key under that name. The wording changes with the provider. When the file names no key at all, the note falls back to the default every example uses, the Claude Code OAuth token.

Renamed Pull Request Explainer

bisque-cloud/presenter · v1.6.0

Now named Pull Request Explainer.

action.yml
- name: Release Explainer
+ name: Pull Request Explainer
Also explains releases.
uses: bisque-cloud/presenter@v1

The Action has a new name, Pull Request Explainer. It was called Release Explainer. The description now opens with pull requests: mention bisque cloud, or let it pick the ones worth explaining. It still explains releases, and the line that uses it in your workflow stays the same.

Watch reads repository channel links

bisque-cloud/presenter · v1.6.0

The watch skill now reads repository channel links.

bisque.today/p/owner/repo/slug
The response gives the handle as owner~repo.

The watch skill lets your agent summarize a published presentation, or answer questions about it. It now accepts the link a repository's channel publishes, with the owner, the repository and the slug after slash p. Pass the link as it is. The response gives the handle as the owner, a tilde, and the repository.

Green no longer proves the explainer ran

bisque-cloud/presenter · v1.6.0

Green no longer proves the explainer ran.

Pull requestsWith no key the run passes. Look for the setup note.
ReleasesA release run with no key still fails: Set one provider key.

This changes what a green check means. On a pull request, a green run can now mean the explainer was skipped, so when no link appears, look for the setup note. An explainer link that already exists stays in place. Releases behave as before. A release run with no key still fails with the same message, because only pull request runs get the note.

Upgrade to v1.6.0

bisque-cloud/presenter · v1.6.0

v1.6.0 needs
no migration.

uses: bisque-cloud/presenter@v1.6.0
Wait if a red check on a missing key is how you learn setup is unfinished. That signal now arrives as a comment.

Version 1.6.0 needs no migration. Move your pin to v1.6.0, or stay on v1. Hold off only if a red check on a missing key is how you learn setup is unfinished, because that signal now arrives as a comment. Otherwise a pull request with no key passes, and the contributor sees one line naming the secret.