Development · Integration
GitHubAGNT

AI agents for GitHub

Where the code — and half the process — lives. AGNT connects to GitHub so agents can read what happens there, reason about it, and act — with a receipt for every run.

Install First-Pass Reviewer → Get AGNT free

First-Pass Reviewer is a ready-made agent that works in GitHub — free, and it runs on your machine.

GitHub and AGNT, in brief

What it doesLets an AGNT agent read from and act in GitHub.
Connects withOne OAuth sign-in
AGNT nodegithub-api
Runs whenA PR opens or merges
Typical build timeTwo minutes
Where data goesNowhere by default — AGNT runs on your machine and credentials never leave it.

What you can automate

Reacts when…

  • a PR opens or merges
  • an issue is filed
  • a release is cut

Agents can…

  • comment on PRs and issues
  • open issues with structured detail
  • draft release notes

Teams use it for

  • first-pass review on every diff
  • issues triaged and labelled on arrival
  • changelogs drafted from merged work

Build it: the GitHub workflow

Design goal for GitHub: first-pass review on every diff; issues triaged and labelled on arrival; changelogs drafted from merged work. The template below supplies configurable nodes, not the complete logic for those goals.

Use this GitHub setup template to arrange the schedule, input review and API operation. Configure the account-specific fields and add your own decision and approval controls before activation.

GitHub workflow: run on a schedule → review source and draft → configure destination in github TRIGGER trigger-timer Run on a schedule Configure activation ACTION agnt-agent Review source and draft Configure inputs ACTION github-api Configure destination in GitHub Configure inputs
Configuration example for GitHub. API and model calls may send data to your selected providers.
GitHub — read, decide, actSetup template · configure before activation

This is a schema-checked starting point, not an end-to-end tested automation. Replace every CONFIGURE_ value, choose the operations you intend, connect credentials and map source outputs into later inputs. An edge orders steps; it does not supply a condition, an approval gate or a field mapping. Add and test those controls explicitly before any write. Cloud APIs and model providers may receive data. Keep the workflow inactive until tested with fixtures.

{
  "id": "c3f4fd69-7b86-4995-a487-6a96a0d9364e",
  "name": "GitHub — read, decide, act",
  "nodes": [
    {
      "id": "0ca43842-ac8f-4ca4-a290-6c3cf6bfec50",
      "text": "Run on a schedule",
      "x": 512,
      "y": 144,
      "isEditing": false,
      "type": "trigger-timer",
      "icon": "clock",
      "category": "trigger",
      "isSelected": false,
      "parameters": {
        "fireOnStart": "No",
        "scheduleType": "Interval",
        "schedule": "Every 15 Minutes"
      },
      "description": "Setup template for Timer Trigger. This trigger node fires the workflow at specified intervals or at a specific time. Configure credentials, inputs and output mapping before use.",
      "error": null,
      "isActive": false,
      "output": null,
      "outputs": {}
    },
    {
      "id": "7a5442fe-ffe6-42bb-af19-c7dd30457572",
      "text": "Review source and draft",
      "x": 512,
      "y": 336,
      "isEditing": false,
      "type": "agnt-agent",
      "icon": "agnt",
      "category": "action",
      "isSelected": false,
      "parameters": {
        "agentId": "CONFIGURE_AGENTID",
        "message": "Read the GitHub item and decide whether it warrants action. Explain your reasoning.\nSource input: CONFIGURE_SOURCE_INPUT. Produce a reviewable draft only; do not take external actions."
      },
      "description": "Setup template for Agent Chat. Chat with an AI agent from your agent library. Select an agent and send messages to interact with it within your workflow. Configure credentials, inputs and output mapping before use.",
      "error": null,
      "isActive": false,
      "output": null,
      "outputs": {}
    },
    {
      "id": "3d2819d8-b02d-40d1-ace7-90799be42f36",
      "text": "Configure destination in GitHub",
      "x": 512,
      "y": 528,
      "isEditing": false,
      "type": "github-api",
      "icon": "connect",
      "category": "action",
      "isSelected": false,
      "parameters": {
        "action": "GET_AUTHENTICATED_USER",
        "owner": "CONFIGURE_OWNER",
        "repo": "CONFIGURE_REPO"
      },
      "description": "Setup template for GitHub API. Interact with GitHub: repos, branches, files, issues, comments, pull requests, reviews, releases, Actions/CI, and search. Configure credentials, inputs and output mapping before use.",
      "error": null,
      "isActive": false,
      "output": null,
      "outputs": {}
    }
  ],
  "edges": [
    {
      "id": "5b7e2900-0607-4dfe-a78e-79d0fe7323ec",
      "start": {
        "id": "0ca43842-ac8f-4ca4-a290-6c3cf6bfec50",
        "type": "output"
      },
      "end": {
        "id": "7a5442fe-ffe6-42bb-af19-c7dd30457572",
        "type": "input"
      },
      "startX": 800,
      "startY": 168,
      "endX": 512,
      "endY": 360
    },
    {
      "id": "e6b88c40-9877-40de-a42a-321c4cc16c44",
      "start": {
        "id": "7a5442fe-ffe6-42bb-af19-c7dd30457572",
        "type": "output"
      },
      "end": {
        "id": "3d2819d8-b02d-40d1-ace7-90799be42f36",
        "type": "input"
      },
      "startX": 800,
      "startY": 360,
      "endX": 512,
      "endY": 552
    }
  ],
  "zoomLevel": 1,
  "canvasOffsetX": 0,
  "canvasOffsetY": 0,
  "isTinyNodeMode": false
}

Configure GitHub API

Interact with GitHub: repos, branches, files, issues, comments, pull requests, reviews, releases, Actions/CI, and search.

  • action — The action to perform on GitHub Current example: GET_AUTHENTICATED_USER.
  • owner — The owner of the repository (not needed for account-level or search actions) Current example: CONFIGURE_OWNER.
  • repo — The name of the repository (for CREATE_REPO: the name of the new repository) Current example: CONFIGURE_REPO.

Install First-Pass Reviewer — it runs on GitHub

First-Pass Reviewer is a working agent that uses GitHub. Installing it drops the whole workflow onto your canvas — connected, editable, and yours to change.

Runs on your own machine · See what it does

Half of engineering process lives here

GitHub holds not just the code but the workflow around it: reviews, issues, releases. That makes it unusually rich for agents, because the events are structured, the API is excellent, and the surrounding work — triage, review, release notes — is exactly the toil engineers most want back.

Comment, do not merge

The right boundary is firm. Agents should read diffs, leave structured review comments, triage issues and draft release notes; merging and deploying stay human. That keeps the value high and the blast radius near zero.

What the GitHub node actually exposes

Interact with GitHub: repos, branches, files, issues, comments, pull requests, reviews, releases, Actions/CI, and search.

What it can do: GET_AUTHENTICATED_USER GET_REPO_INFO LIST_REPOS CREATE_REPO FORK_REPO LIST_BRANCHES CREATE_BRANCH DELETE_BRANCH GET_FILE_CONTENT GET_REPO_CONTENTS CREATE_FILE UPDATE_FILE DELETE_FILE CREATE_ISSUE LIST_ISSUES GET_ISSUE UPDATE_ISSUE COMMENT_ON_ISSUE LIST_COMMENTS ADD_LABELS REMOVE_LABELS CREATE_PR LIST_PRS GET_PR UPDATE_PR MERGE_PR GET_PR_CHANGES CREATE_PR_REVIEW LIST_PR_REVIEWS REQUEST_REVIEWERS LIST_COMMITS GET_COMMIT COMPARE_COMMITS CREATE_RELEASE LIST_RELEASES GET_LATEST_RELEASE UPLOAD_RELEASE_ASSET LIST_WORKFLOWS LIST_WORKFLOW_RUNS GET_WORKFLOW_RUN TRIGGER_WORKFLOW RERUN_WORKFLOW GET_CHECK_RUNS SEARCH_ISSUES SEARCH_CODE SEARCH_REPOS

Full GitHub API parameter reference
ParameterTypeWhat it does
actionrequired string The action to perform on GitHub
GET_AUTHENTICATED_USER · GET_REPO_INFO · LIST_REPOS · CREATE_REPO · FORK_REPO · LIST_BRANCHES · CREATE_BRANCH · DELETE_BRANCH
ownerrequired string The owner of the repository (not needed for account-level or search actions)
reporequired string The name of the repository (for CREATE_REPO: the name of the new repository)
title string The title of the issue or pull request
only when action is CREATE_ISSUE or UPDATE_ISSUE or CREATE_PR or UPDATE_PR
body string The body text (issue/PR description, comment body, or review body)
only when action is CREATE_ISSUE or UPDATE_ISSUE or CREATE_PR or UPDATE_PR
issueNumber string The number of the issue (or PR, for comments/labels)
only when action is GET_ISSUE or UPDATE_ISSUE or COMMENT_ON_ISSUE or LIST_COMMENTS
pullNumber string The number of the pull request
only when action is GET_PR or UPDATE_PR or MERGE_PR or GET_PR_CHANGES
head string The branch with your changes (CREATE_PR) or the head ref (COMPARE_COMMITS)
only when action is CREATE_PR or COMPARE_COMMITS
base string The branch to merge into (CREATE_PR/UPDATE_PR) or the base ref (COMPARE_COMMITS)
only when action is CREATE_PR or UPDATE_PR or COMPARE_COMMITS
draft boolean Create as a draft (PR or release)
only when action is CREATE_PR or CREATE_RELEASE
baseBranch string The branch to create the new branch from
only when action is CREATE_BRANCH
newBranch string The name of the new branch to create
only when action is CREATE_BRANCH

31 further parameters are available on the node itself.

Every parameter above is read from the shipped github-api node, so it cannot drift from the product.

Connect GitHub in two minutes

  1. Download AGNT Community Core — free, local-first, no account needed to run.
  2. Connect with one OAuth sign-in from AGNT’s vault — tokens are stored encrypted on your machine and never leave it.
  3. Drop the GitHub node into a workflow or hand it to an agent — the first run produces a receipt you can read line by line.

GitHub + AGNT — common questions

Does my code leave the machine?

Only if you choose a hosted model. Point AGNT at a local model and review runs entirely on your own hardware.

Can an agent merge pull requests?

It can be granted that permission, and almost nobody should. Comment and prepare is where the value sits.

What events can start a workflow?

A pull request opening or merging, an issue being filed, or a release being cut.

Give AI a job. Get the proof.