Skip to content
GitHub Agentic Workflows

Quick Start

Adding an Automated Daily Status Workflow to Your Repo

Section titled “Adding an Automated Daily Status Workflow to Your Repo”

In this guide you will add the automated Daily Repo Status Report to an existing GitHub repository where you are a maintainer, running in GitHub Actions.

Remember the aim here is automated AI: to install something that will run automatically every day, in the context of your repository, and create a fresh status report issue in your repository without any further manual intervention. If you’re familiar with GitHub Actions, you will be aware of the power of automation.

There are hundreds of other ways to use GitHub Agentic Workflows, which you can explore in Peli’s Agent Factory. This workflow is just the start of what’s possible.

Prerequisites

Section titled “Prerequisites”

Before installing, ensure you have:

  • ✅ AI Account - A GitHub Copilot subscription, or a Anthropic Claude or OpenAI Codex API key
  • ✅ GitHub Repository - a GitHub repository you are maintainer on
  • ✅ GitHub Actions enabled in your repository
  • ✅ GitHub CLI (gh) - A command-line tool for GitHub. Install here v2.0.0+
  • ✅ Operating System: Linux, macOS, or Windows with WSL

Step 1 — Install the extension

Section titled “Step 1 — Install the extension”

Install the GitHub CLI, then install the GitHub Agentic Workflows extension:

Terminal window
gh extension install github/gh-aw

Step 2 — Add the sample workflow and trigger a run

Section titled “Step 2 — Add the sample workflow and trigger a run”

From your repository root run:

Terminal window
gh aw add githubnext/agentics/daily-repo-status

This will take you through an interactive process to:

  1. Select an AI Engine - You’ll be prompted to choose between Claude, Copilot, or Codex
  2. Add the workflow - Configure your first agentic workflow and set up required secrets
  3. Trigger an initial run - Start the workflow immediately to see it in action

Once your initial run is complete, a new issue will be created in your repository with a “repo status report”. The report will be automatically generated by the AI based on recent activity in your repository, including issues, PRs, discussions, releases, and code changes. It will analyze:

  • Recent repository activity (issues, PRs, discussions, releases, code changes)
  • Progress tracking, goal reminders and highlights
  • Project status and recommendations
  • Actionable next steps for maintainers

Going further — Customize your workflow

Section titled “Going further — Customize your workflow”

The report is fully customizable. If you like, you can now customize the workflow by editing the workflow markdown file located at .github/workflows/daily-repo-status.md in your repository. You then run

Terminal window
gh aw compile

to regenerate the workflow YAML file .github/workflows/daily-repo-status.lock.yml, then push to your repository. You can then trigger another run by running:

Terminal window
gh aw run daily-repo-status

or by using the GitHub UX.

Some ideas for customization:

  • Adjust the schedule to run more or less frequently
  • Modify the style or content of the report
  • Add additional data sources or metrics to analyze
  • Focus in on specific areas of your repository or project
  • Adjust the instructions to analyze patterns in failed CI runs or test coverage
  • Request analysis of compliance with organizational standards
  • Request analysis of spam or inappropriate content in issues or PRs
  • Request analysis of ways the repository could be modernized or simplified
  • And much more!

Alternatively, you can browse some of the sample workflows in Peli’s Agent Factory and add them to your repository using gh aw add <workflow-spec>, or remix them to create your own workflows.

What’s next?

Section titled “What’s next?”

With that, you are up and running with your first automated agentic workflow!

Explore further with:

Made with by GitHub Next & Microsoft Research Terms of Service