Skip to content

The animation engine for agents: blazingly fast math and 3D videos with Manim's Python API, on a Rust GPU core.

Python

Run Claude only when a maintainer mentions @claude

Sina Atalaycfd33af5aa7c
diff --git a/.github/workflows/claude.yaml b/.github/workflows/claude.yaml
index f5c855e4..c5ff931b 100644
--- a/.github/workflows/claude.yaml
+++ b/.github/workflows/claude.yaml
@@ -2,12 +2,10 @@
# Claude GitHub App installed on the repository, and runs on a Claude subscription: its token is
# the `ai` environment's secret CLAUDE_CODE_OAUTH_TOKEN (`claude setup-token`), good for a year.
#
-# - A pull request from this repository is reviewed when it's opened or marked ready, with
-# Anthropic's code-review plugin: inline comments on the problems it's sure of.
-# - A maintainer asks for anything with "@claude" in an issue or a pull request's conversation:
-# an answer, a review, or a change, which Claude makes on a branch and opens as a draft pull
-# request. It may run any command Claude Code's auto mode allows; on a pull request from a
-# fork, it only reads.
+# It runs only when a maintainer asks, with "@claude" in an issue or a pull request's
+# conversation, for anything: an answer, a review, or a change, which Claude makes on a branch
+# and opens as a draft pull request. It may run any command Claude Code's auto mode allows; on a
+# pull request from a fork, it only reads.
name: Claude
@@ -16,49 +14,10 @@ on:
types: [opened]
issue_comment:
types: [created]
- pull_request:
- types: [opened, ready_for_review]
permissions: {}
-env:
- MODEL: claude-opus-5-5
-
jobs:
- review:
- name: Review the pull request
- # a pull request from this repository, once it's ready (a fork's gets no secrets: a
- # maintainer asks "@claude review this" there)
- if: >-
- github.event_name == 'pull_request' && !github.event.pull_request.draft
- && github.event.pull_request.head.repo.full_name == github.repository
- && github.event.pull_request.user.type != 'Bot'
- runs-on: ubuntu-24.04
- timeout-minutes: 55 # the Claude App's token lasts an hour
- environment:
- name: ai
- deployment: false
- permissions:
- contents: read
- pull-requests: read
- issues: read
- id-token: write # the Claude App's token
- steps:
- - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- with:
- persist-credentials: false
-
- # --comment posts the findings on the pull request (without it they stay in the log)
- - uses: anthropics/claude-code-action@a26b07d8c778b0c43f64618e5fd29fd0f8af72e8 # v1.0.250
- with:
- claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
- plugin_marketplaces: https://github.com/anthropics/claude-code.git
- plugins: code-review@claude-code-plugins
- prompt: /code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}
- claude_args: >-
- --model ${{ env.MODEL }}
- --allowedTools "mcp__github_inline_comment__create_inline_comment"
-
assistant:
name: Answer @claude
# an issue or a comment that mentions @claude; the first step checks that its author can
@@ -66,9 +25,9 @@ jobs:
# request's own copy of this file)
if: >-
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')
- && contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR", "CONTRIBUTOR"]'), github.event.comment.author_association))
+ && contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR"]'), github.event.comment.author_association))
|| (github.event_name == 'issues' && contains(github.event.issue.body, '@claude')
- && contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR", "CONTRIBUTOR"]'), github.event.issue.author_association))
+ && contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR"]'), github.event.issue.author_association))
runs-on: ubuntu-24.04
timeout-minutes: 55 # the Claude App's token lasts an hour
environment:
@@ -136,7 +95,7 @@ jobs:
additional_permissions: |
actions: read
claude_args: >-
- --model ${{ env.MODEL }}
+ --model claude-opus-5-5
${{ steps.author.outputs.fork == 'true'
&& '--disallowedTools Edit,Write,NotebookEdit,Bash'
|| '--permission-mode auto' }}
diff --git a/docs/content/developer-guide/github-workflows.md b/docs/content/developer-guide/github-workflows.md
index 9d2debaf..7d58c517 100644
--- a/docs/content/developer-guide/github-workflows.md
+++ b/docs/content/developer-guide/github-workflows.md
@@ -10,8 +10,8 @@ Some tasks must run the same way every time:
- **For every release:** test; build the wheels, the source distribution, the font
packages and the executables; publish them to GitHub and PyPI, the package for the
browser to npm, and the Docker image to ghcr.io.
-- **For every pull request and issue:** a review once a pull request is ready, and an
- assistant that a maintainer can ask.
+- **When a maintainer mentions @claude**, in an issue or a pull request: an answer, a
+ review or a change, by Claude.
- **When a maintainer requests an update:** review and update pinned actions and dependencies.
Done by hand, steps get forgotten, and every run costs someone's time.
@@ -254,22 +254,17 @@ runs on a Claude subscription, whose token is the `ai` environment's secret
`CLAUDE_CODE_OAUTH_TOKEN`. `claude setup-token` makes one, good for a year; a maintainer
makes the next before it expires.
-**When it runs:** a pull request is opened or marked ready for review, an issue is opened,
-or a comment is made on an issue or a pull request.
-
-**What it does**, in two ways:
-
-- **A review** of a pull request from a branch of the repository (not a draft, and not a
- bot's), when it is opened or marked ready: Anthropic's code-review plugin, with Claude
- Opus, comments on the problems it is sure of.
-- **@claude:** a maintainer mentions @claude in a new issue, or in a comment on an issue or
- a pull request, and asks for anything: an answer, a review, a change. The job first
- checks that the author can write to the repository, and stops otherwise. Claude Opus
- works in the environment `just sync` makes, in Claude Code's auto mode: it runs any
- command a classifier allows, with no list of commands to keep. It is told to follow
- [`AGENTS.md`](https://github.com/academa-labs/manimgx/blob/main/AGENTS.md), to run
- `just check` and the tests its change touches before it pushes, and to open a change as
- a draft pull request. On a pull request from a fork, it only reads.
+**When it runs:** only when a maintainer mentions @claude, in a new issue or in a comment
+on an issue or a pull request. Nothing runs on its own: a pull request is reviewed when
+someone asks for it.
+
+**What it does:** whatever it is asked: an answer, a review, a change. The job first checks
+that the author can write to the repository, and stops otherwise. Claude Opus works in the
+environment `just sync` makes, in Claude Code's auto mode: it runs any command a classifier
+allows, with no list of commands to keep. It is told to follow
+[`AGENTS.md`](https://github.com/academa-labs/manimgx/blob/main/AGENTS.md), to run
+`just check` and the tests its change touches before it pushes, and to open a change as a
+draft pull request. On a pull request from a fork, it only reads.
## Deployment credentials