> ## Documentation Index
> Fetch the complete documentation index at: https://docs.architect.new/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> The GitHub tool transforms your AI agents into autonomous software developers and repository managers. By connecting GitHub to Architect, your apps can dynamically read code, analyze commits, manage pull requests, and triage issues across your repositories.

## Why Use GitHub in Architect?

Vibe coding isn't just for building end-user apps; it's perfect for building your own internal developer tooling. Instead of relying on rigid CI/CD scripts or manual code reviews, you can simply tell your agent how you want your repository managed. The GitHub tool empowers the AI to act as a tireless open-source maintainer or an extra pair of eyes on your team's code.

* **Automated Code Reviews:** Build agents that automatically pull the latest PRs, analyze the code for security flaws or anti-patterns, and leave actionable comments.
* **Intelligent Issue Triaging:** Stop manually tagging bugs. Have your agent read incoming issues, reproduce steps conceptually, assign the right labels (e.g., 'bug', 'enhancement'), and ping the relevant developer.
* **Documentation Generation:** Instruct your agent to read through a specific folder in your repo and automatically draft comprehensive READMEs or technical docs.

## Vibe Coding Examples

Try these natural language prompts in Architect to build powerful GitHub automations:

<CardGroup cols={1}>
  <Card title="Example 1: The Automated Code Reviewer">
    "Build a code review assistant. Use the GitHub tool to fetch the latest open Pull Request in my repository. Analyze the diff for potential performance bottlenecks and security issues, and then post a summary comment on the PR."
  </Card>

  <Card title="Example 2: The Issue Triage Manager">
    "Create an app that manages my open-source repo. Whenever a new issue is created, read its contents. If it mentions 'UI' or 'CSS', use the GitHub tool to add a 'frontend' label and assign it to the design team."
  </Card>

  <Card title="Example 3: Release Notes Generator">
    "I need a release note generator. Use the GitHub tool to fetch all the commit messages from the past week on the main branch. Group them logically into 'Features', 'Fixes', and 'Chores', and format them into a clean markdown changelog."
  </Card>
</CardGroup>

<Tip>
  Vibe code an ultimate dev-ops agent by combining the GitHub tool with Slack or Microsoft Teams. Have the agent review a PR and immediately send a direct message to the author with a summary of the feedback!
</Tip>

## Available Actions

The GitHub tool exposes the following actions to your agents. Architect automatically picks the right one based on your prompt.

<Accordion title="View all 100 GitHub actions" icon="list">
  * `GITHUB_ACCEPT_A_REPOSITORY_INVITATION`
  * `GITHUB_ACTIVITY_LIST_REPO_S_STARRED_BY_AUTHENTICATED_USER`
  * `GITHUB_ACTIVITY_LIST_STARGAZERS_FOR_REPO`
  * `GITHUB_ACTIVITY_STAR_REPO_FOR_AUTHENTICATED_USER`
  * `GITHUB_ADD_AN_EMAIL_ADDRESS_FOR_THE_AUTHENTICATED_USER`
  * `GITHUB_ADD_APP_ACCESS_RESTRICTIONS`
  * `GITHUB_ADD_A_REPOSITORY_COLLABORATOR`
  * `GITHUB_ADD_A_REPOSITORY_TO_AN_APP_INSTALLATION`
  * `GITHUB_ADD_A_SELECTED_REPOSITORY_TO_A_USER_SECRET`
  * `GITHUB_ADD_ASSIGNEES_TO_AN_ISSUE`
  * `GITHUB_ADD_LABELS_TO_AN_ISSUE`
  * `GITHUB_ADD_ORG_RUNNER_LABELS`
  * `GITHUB_ADD_OR_UPDATE_TEAM_MEMBERSHIP_FOR_A_USER`
  * `GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONS`
  * `GITHUB_ADD_OR_UPDATE_TEAM_REPOSITORY_PERMISSIONS`
  * `GITHUB_ADD_PROJECT_COLLABORATOR`
  * `GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_ACCESS`
  * `GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_VISIBILITY`
  * `GITHUB_ADD_RUNNER_LABELS`
  * `GITHUB_ADD_SELECTED_REPOSITORY_TO_AN_ORGANIZATION_SECRET`
  * `GITHUB_ADD_SELECTED_REPOSITORY_TO_AN_ORGANIZATION_VARIABLE`
  * `GITHUB_ADD_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER`
  * `GITHUB_ADD_STATUS_CHECK_CONTEXTS`
  * `GITHUB_ADD_TEAM_ACCESS_RESTRICTIONS`
  * `GITHUB_ADD_USER_ACCESS_RESTRICTIONS`
  * `GITHUB_ADD_USERS_TO_CODESPACES_ACCESS_FOR_AN_ORGANIZATION`
  * `GITHUB_APPROVE_A_WORKFLOW_RUN_FOR_A_FORK_PULL_REQUEST`
  * `GITHUB_ASSIGN_AN_ORGANIZATION_ROLE_TO_A_TEAM`
  * `GITHUB_ASSIGN_AN_ORGANIZATION_ROLE_TO_A_USER`
  * `GITHUB_AUTH_USER_DOCKER_CONFLICT_PACKAGES_LIST`
  * `GITHUB_BLOCK_A_USER`
  * `GITHUB_BLOCK_A_USER_FROM_AN_ORGANIZATION`
  * `GITHUB_CANCEL_A_GITHUB_PAGES_DEPLOYMENT`
  * `GITHUB_CANCEL_A_WORKFLOW_RUN`
  * `GITHUB_CHECK_A_TOKEN`
  * `GITHUB_CHECK_IF_A_GIST_IS_STARRED`
  * `GITHUB_CHECK_IF_A_PERSON_IS_FOLLOWED_BY_THE_AUTHENTICATED_USER`
  * `GITHUB_CHECK_IF_A_PULL_REQUEST_HAS_BEEN_MERGED`
  * `GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_AUTHENTICATED_USER`
  * `GITHUB_CHECK_IF_A_USER_CAN_BE_ASSIGNED`
  * `GITHUB_CHECK_IF_A_USER_CAN_BE_ASSIGNED_TO_A_ISSUE`
  * `GITHUB_CHECK_IF_A_USER_FOLLOWS_ANOTHER_USER`
  * `GITHUB_CHECK_IF_A_USER_IS_A_REPOSITORY_COLLABORATOR`
  * `GITHUB_CHECK_IF_A_USER_IS_BLOCKED_BY_AN_ORGANIZATION`
  * `GITHUB_CHECK_IF_A_USER_IS_BLOCKED_BY_THE_AUTHENTICATED_USER`
  * `GITHUB_CHECK_PRIVATE_VULNERABILITY_REPORTING_STATUS`
  * `GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_PROJECT`
  * `GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_REPOSITORY`
  * `GITHUB_CLEAR_REPOSITORY_CACHE_BY_KEY`
  * `GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELS`
  * `GITHUB_COMPARE_TWO_COMMITS`
  * `GITHUB_CONFIGURE_JITRUNNER_FOR_ORG`
  * `GITHUB_CONFIGURE_OIDCSUBJECT_CLAIM_TEMPLATE`
  * `GITHUB_CONVERT_AN_ORGANIZATION_MEMBER_TO_OUTSIDE_COLLABORATOR`
  * `GITHUB_CREATE_A_BLOB`
  * `GITHUB_CREATE_A_CHECK_RUN`
  * `GITHUB_CREATE_A_CHECK_SUITE`
  * `GITHUB_CREATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER`
  * `GITHUB_CREATE_A_CODESPACE_FROM_A_PULL_REQUEST`
  * `GITHUB_CREATE_A_CODESPACE_IN_A_REPOSITORY`
  * `GITHUB_CREATE_A_COMMIT`
  * `GITHUB_CREATE_A_COMMIT_COMMENT`
  * `GITHUB_CREATE_A_COMMIT_STATUS`
  * `GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLE`
  * `GITHUB_CREATE_A_DEPLOY_KEY`
  * `GITHUB_CREATE_A_DEPLOYMENT`
  * `GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICY`
  * `GITHUB_CREATE_A_DEPLOYMENT_STATUS`
  * `GITHUB_CREATE_A_DISCUSSION`
  * `GITHUB_CREATE_A_DISCUSSION_COMMENT`
  * `GITHUB_CREATE_A_FORK`
  * `GITHUB_CREATE_A_GIST`
  * `GITHUB_CREATE_A_GIST_COMMENT`
  * `GITHUB_CREATE_A_GITHUB_APP_FROM_A_MANIFEST`
  * `GITHUB_CREATE_A_GITHUB_PAGES_DEPLOYMENT`
  * `GITHUB_CREATE_A_GITHUB_PAGES_SITE`
  * `GITHUB_CREATE_A_LABEL`
  * `GITHUB_CREATE_A_MILESTONE`
  * `GITHUB_CREATE_AN_AUTOLINK_REFERENCE_FOR_A_REPOSITORY`
  * `GITHUB_CREATE_AN_ENVIRONMENT_VARIABLE`
  * `GITHUB_CREATE_AN_ISSUE`
  * `GITHUB_CREATE_AN_ISSUE_COMMENT`
  * `GITHUB_CREATE_AN_ORGANIZATION_PROJECT`
  * `GITHUB_CREATE_AN_ORGANIZATION_REPOSITORY`
  * `GITHUB_CREATE_AN_ORGANIZATION_VARIABLE`
  * `GITHUB_CREATE_AN_ORGANIZATION_WEBHOOK`
  * `GITHUB_CREATE_A_PROJECT_CARD`
  * `GITHUB_CREATE_A_PROJECT_COLUMN`
  * `GITHUB_CREATE_A_PULL_REQUEST`
  * `GITHUB_CREATE_A_REFERENCE`
  * `GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_AN_ORGANIZATION`
  * `GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORY`
  * `GITHUB_CREATE_A_RELEASE`
  * `GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATION`
  * `GITHUB_CREATE_A_REMOVE_TOKEN_FOR_A_REPOSITORY`
  * `GITHUB_CREATE_A_REPLY_FOR_A_REVIEW_COMMENT`
  * `GITHUB_CREATE_A_REPOSITORY_DISPATCH_EVENT`
  * `GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER`
  * `GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACE`
  * `GITHUB_CREATE_A_REPOSITORY_PROJECT`
</Accordion>