GitHub Agentic Workflows

GitHub Agentic Workflows GA: Setup, Security and Costs

•Make Better Editorial

GitHub Agentic Workflows is now GA. See how Markdown automations compile into Actions, what licenses and runs cost, and the security limits.

On October 28, 2026, GitHub made Agentic Workflows generally available. The open-source project lets maintainers describe recurring repository tasks in Markdown and run coding agents inside GitHub Actions. Typical jobs include issue triage, investigating failed CI, preparing documentation changes and proposing tests. The key distinction is that these workflows use natural-language reasoning while still producing ordinary, inspectable Actions workflow files.

What became generally available

A workflow has YAML frontmatter for triggers, permissions, tools and allowed outputs, followed by natural-language instructions. The `gh aw` extension compiles the Markdown source into a `.lock.yml` file that GitHub Actions executes. GitHub says the GA release adds stronger budget forecasting, model routing, additional workflow templates, Actions Runner Controller support and more isolation options. These are workflow capabilities, not a promise that every agent or runner configuration is supported without setup.

Make Better analysis

For an engineering team, this changes the economics of repetitive, judgment-heavy maintenance. A scheduled workflow can examine failing tests, explain likely causes and open a reviewable issue without someone writing a new procedural script for every exception. It should not replace deterministic CI checks: builds, tests and deployment gates remain better expressed as explicit steps. Use agent reasoning where context matters, and ordinary Actions steps where repeatability matters.

How to run a first workflow

  1. Choose a repository where you have write access and GitHub Actions is enabled; confirm your coding-agent account and organization policies.
  2. Install the GitHub CLI and the `github/gh-aw` extension, then authenticate with the required repository and workflow scopes.
  3. Use `gh aw add-wizard githubnext/agentics/repo-status` to add the official daily repository report example, or create a Markdown workflow manually.
  4. Review the YAML frontmatter, especially triggers, permissions, network access, AI engine and declared safe outputs.
  5. Commit both the Markdown source and generated `.lock.yml`; compile again after changes to frontmatter.
  6. Trigger a run in Actions or with `gh aw run`, inspect its logs and output, and only then schedule recurring execution.

The quickstart's report workflow is a sensible pilot because its output is an issue that a maintainer can inspect. Avoid beginning with production deployments, credential changes or automatic merges. If the run fails, check the Actions job logs, authentication and policy settings before expanding permissions. The GitHub guide estimates about ten minutes for the example, but real setup time depends on repository rules and the chosen engine.

Security: read-only agents, controlled writes

GitHub's documented design uses read-only agent execution by default, network isolation and a firewall, then separates write operations into declared safe-output jobs. Proposed changes pass through validation and a threat-detection stage. That architecture narrows the agent's direct authority, but it does not make all generated content trustworthy. The security documentation explicitly describes configuration mistakes, privileged custom steps and trusted-runner assumptions as remaining risks. Review permissions, external tools and generated pull requests as carefully as conventional automation.

Important security qualification

Threat detection is defense in depth, not a guarantee. GitHub documents a default warn mode for certain detection failures or flagged outputs: some reviewable outputs may still be surfaced with annotations, while non-reviewable operations are aborted. Teams requiring fail-closed behavior should evaluate the documented strict-mode setting and test it before relying on automated writes.

Licensing and real operating costs

GitHub Agentic Workflows is generally available on github.com for GitHub Free, Team and Enterprise. That availability is not the same as free AI inference: the default GitHub Copilot CLI engine requires a Copilot license, while supported third-party engines require their own credentials and billing. Total cost combines Actions minutes and the selected engine's inference. GitHub's AI Credits provide an estimate, not a universal invoice rate, and usage can vary with task complexity and threat-detection steps.

Budget before enabling recurring runs

Cost or controlWhat to check
Actions executionRunner minutes, frequency and any self-hosted infrastructure costs
Agent inferenceCopilot plan or third-party provider account, model selection and billing
Per-run controls`max-ai-credits` limit and `gh aw forecast` estimates
Organization billingCopilot policy and `copilot-requests: write` when using the built-in Actions token

For an organization-owned repository, GitHub documents a built-in `GITHUB_TOKEN` billing path when administrators allow Copilot CLI charges to the organization and the workflow requests `copilot-requests: write`. This avoids relying on a personal token, but it also changes who pays. Inspect cost-center policy, run frequency and provider invoices. GitHub warns that its AI-credit estimates may not exactly match final provider charges.

Where it fits—and where it does not

Start with a bounded task whose result is easy to verify: an issue summary, a draft documentation pull request or an explanation of a failed build. Measure useful outputs, false positives, runtime, cost and human correction effort. A rule-based Actions job remains preferable for deterministic deployment steps. GitHub Copilot Dynamic Workflows, covered separately on Make Better, orchestrates agent stages within Copilot; Agentic Workflows specifically turns Markdown-defined repository automation into GitHub Actions jobs. The similar names do not make them interchangeable.

FAQ

Questions people ask

Do I need a paid GitHub Copilot plan to use GitHub Agentic Workflows?

Not necessarily. GitHub says Agentic Workflows is generally available for repositories on GitHub Free, Team and Enterprise, but the default Copilot CLI engine requires a Copilot license. You can instead configure a supported third-party coding agent, such as Claude Code, OpenAI Codex or Gemini, with its own account and authentication. GitHub Actions usage and the chosen engine's inference charges may still apply.

How do I create and run my first GitHub Agentic Workflow?

Install and authenticate the GitHub CLI, then install the extension with `gh extension install github/gh-aw`. In a repository with Actions enabled and write access, use the documented `gh aw add-wizard githubnext/agentics/repo-status` example or create a Markdown workflow under `.github/workflows/`. Compile it, commit both the Markdown and generated `.lock.yml`, and run it from Actions or `gh aw run`. Review permissions and engine authentication first.

Can a GitHub Agentic Workflow modify a repository automatically?

It can propose and perform specifically configured write actions, but the agent starts with read-only repository permissions. GitHub routes declared safe outputs, such as issues or pull requests, through separate jobs and threat-detection checks. Do not interpret that as guaranteed approval or safety: GitHub documents a default warn-mode policy that can still surface reviewable outputs after warnings. Limit permissions, inspect generated changes and require human review for sensitive merges or deployments.

How much does GitHub Agentic Workflows cost?

There is no single fixed price per workflow. GitHub documents two cost components: GitHub Actions minutes and inference from the selected agent engine. It tracks inference using AI Credits, with one AIC representing $0.01 for estimation; actual third-party provider bills can differ. Use `gh aw logs`, `gh aw audit` and `gh aw forecast` to inspect usage, and set `max-ai-credits` per run where appropriate. Check your provider and organization billing policies.

Bottom line

GitHub Agentic Workflows GA makes recurring AI-assisted repository maintenance easier to define and run, with useful permission separation and cost tools. The practical first move is a read-only or reviewable pilot, not an autonomous production operator. Validate engine licensing, cost limits, trigger permissions and safe outputs before turning a successful experiment into a scheduled workflow.

Explore related Make Better resources

Sources & useful resources