Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/github-actions
https://code.claude.com/docs/en/commands
Section/Topic
Setup -> Quick setup and Manual setup for /install-github-app.
Current Documentation
The current quick setup text says:
The easiest way to set up this action is through Claude Code in the terminal. Just open claude and run /install-github-app.
This command will guide you through setting up the GitHub app and required secrets.
Local evidence: docs/code.claude.com/docs/en/github-actions.md:37-39
The note still presents secrets as part of the required setup path:
You must be a repository admin to install the GitHub app and add secrets
Local evidence: docs/code.claude.com/docs/en/github-actions.md:41-43
The commands reference describes /install-github-app only as GitHub Actions setup:
/install-github-app | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration
Local evidence: docs/code.claude.com/docs/en/commands.md:87
What's Wrong or Missing?
Claude Code v2.1.187 changed /install-github-app so GitHub Actions workflow setup is optional. Users can install just the GitHub App and skip the workflow and secret steps.
The current docs still imply that /install-github-app always guides users through GitHub App setup plus required secrets, and the manual setup path still presents ANTHROPIC_API_KEY and .github/workflows/ setup as mandatory follow-on steps. That omits the new App-only path.
Suggested Improvement
Update the GitHub Actions quick setup section to distinguish the two setup choices. For example:
Run /install-github-app from Claude Code to install the Claude GitHub App for a repository. During setup, you can choose whether to also configure the GitHub Actions workflow. If you only need the GitHub App, you can skip the workflow and repository-secret steps.
Then update the note and manual setup steps so ANTHROPIC_API_KEY and workflow-file creation are described as required only when configuring GitHub Actions workflows, not when installing only the GitHub App. Also update the /install-github-app row in the commands reference to mention that workflow setup is optional.
Impact
Medium - Makes feature difficult to understand
Additional Context
Release context: Claude Code v2.1.187 release note says: Improved /install-github-app: GitHub Actions workflow setup is now optional — you can install just the GitHub App and skip the workflow/secret steps.
Duplicate check found no open issue titles matching install-github-app, workflow setup, secret steps, or optional workflow.
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/github-actions
https://code.claude.com/docs/en/commands
Section/Topic
Setup->Quick setupandManual setupfor/install-github-app.Current Documentation
The current quick setup text says:
Local evidence:
docs/code.claude.com/docs/en/github-actions.md:37-39The note still presents secrets as part of the required setup path:
Local evidence:
docs/code.claude.com/docs/en/github-actions.md:41-43The commands reference describes
/install-github-apponly as GitHub Actions setup:Local evidence:
docs/code.claude.com/docs/en/commands.md:87What's Wrong or Missing?
Claude Code v2.1.187 changed
/install-github-appso GitHub Actions workflow setup is optional. Users can install just the GitHub App and skip the workflow and secret steps.The current docs still imply that
/install-github-appalways guides users through GitHub App setup plus required secrets, and the manual setup path still presentsANTHROPIC_API_KEYand.github/workflows/setup as mandatory follow-on steps. That omits the new App-only path.Suggested Improvement
Update the GitHub Actions quick setup section to distinguish the two setup choices. For example:
Then update the note and manual setup steps so
ANTHROPIC_API_KEYand workflow-file creation are described as required only when configuring GitHub Actions workflows, not when installing only the GitHub App. Also update the/install-github-approw in the commands reference to mention that workflow setup is optional.Impact
Medium - Makes feature difficult to understand
Additional Context
Release context: Claude Code v2.1.187 release note says:
Improved /install-github-app: GitHub Actions workflow setup is now optional — you can install just the GitHub App and skip the workflow/secret steps.Duplicate check found no open issue titles matching
install-github-app,workflow setup,secret steps, oroptional workflow.