{"id":30436746,"url":"https://github.com/githubnext/gh-aw","last_synced_at":"2026-02-02T18:16:22.481Z","repository":{"id":310099985,"uuid":"1036865607","full_name":"githubnext/gh-aw","owner":"githubnext","description":"GitHub Agentic Workflows","archived":false,"fork":false,"pushed_at":"2026-01-21T01:33:51.000Z","size":372565,"stargazers_count":308,"open_issues_count":79,"forks_count":36,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-21T02:27:18.874Z","etag":null,"topics":["actions","cai","ci","claude-code","codex","copilot","gh-extension","github-actions"],"latest_commit_sha":null,"homepage":"https://gh.io/gh-aw","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/githubnext.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-12T17:40:41.000Z","updated_at":"2026-01-21T01:27:33.000Z","dependencies_parsed_at":"2025-08-15T19:31:45.088Z","dependency_job_id":"dc3ffd68-ba5f-4e9c-898f-88dfee0f82bb","html_url":"https://github.com/githubnext/gh-aw","commit_stats":null,"previous_names":["githubnext/gh-aw"],"tags_count":143,"template":false,"template_full_name":null,"purl":"pkg:github/githubnext/gh-aw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/githubnext%2Fgh-aw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/githubnext%2Fgh-aw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/githubnext%2Fgh-aw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/githubnext%2Fgh-aw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/githubnext","download_url":"https://codeload.github.com/githubnext/gh-aw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/githubnext%2Fgh-aw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28677715,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T01:00:35.747Z","status":"online","status_checked_at":"2026-01-23T02:00:08.296Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","cai","ci","claude-code","codex","copilot","gh-extension","github-actions"],"created_at":"2025-08-23T02:18:57.694Z","updated_at":"2026-01-27T23:33:42.870Z","avatar_url":"https://github.com/githubnext.png","language":"Go","readme":"# GitHub Agentic Workflows\n\nWrite agentic workflows in natural language markdown, and run them in GitHub Actions.\n\n## Contents\n\n- [Quick Start](#quick-start)\n- [Overview](#overview)\n- [How It Works](#how-it-works)\n- [Safe Agentic Workflows](#safe-agentic-workflows)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [Share Feedback](#share-feedback)\n- [Peli's Agent Factory](#pelis-agent-factory)\n- [Related Projects](#related-projects)\n\n## Quick Start\n\nReady to get your first agentic workflow running? Follow our step-by-step [Quick Start Guide](https://githubnext.github.io/gh-aw/setup/quick-start/) to install the extension, add a sample workflow, and see it in action.\n\n## Overview\n\nLearn about the concepts behind agentic workflows, explore available workflow types, and understand how AI can automate your repository tasks. See [How It Works](https://githubnext.github.io/gh-aw/introduction/how-it-works/).\n\n## How It Works\n\nGitHub Agentic Workflows transforms natural language markdown files into GitHub Actions that are executed by AI agents. Here's an example:\n\n```markdown\n---\non:\n  schedule: daily\npermissions:\n  contents: read\n  issues: read\n  pull-requests: read\nsafe-outputs:\n  create-issue:\n    title-prefix: \"[team-status] \"\n    labels: [report, daily-status]\n    close-older-issues: true\n---\n\n## Daily Issues Report\n\nCreate an upbeat daily status report for the team as a GitHub issue.\n```\n\nThe `gh aw` cli converts this into a GitHub Actions Workflow (.yml) that runs an AI agent (Copilot, Claude, Codex, ...) in a containerized environment on a schedule or manually.\n\nThe AI agent reads your repository context, analyzes issues, generates visualizations, and creates reports - all defined in natural language rather than complex code.\n\n## Safe Agentic Workflows\n\nSecurity is foundational to GitHub Agentic Workflows. Workflows run with read-only permissions by default, with write operations only allowed through sanitized `safe-outputs`. The system implements multiple layers of protection including sandboxed execution, input sanitization, network isolation, supply chain security (SHA-pinned dependencies), tool allow-listing, and compile-time validation. Access can be gated to team members only, with human approval gates for critical operations, ensuring AI agents operate safely within controlled boundaries. See the [Security Guide](https://githubnext.github.io/gh-aw/guides/security/) for comprehensive details on threat modeling, implementation guidelines, and best practices.\n\n\u003e [!WARNING]\n\u003e Using agentic workflows in your repository requires careful attention to security considerations and careful human supervision, and even then things can still go wrong. Use it with caution, and at your own risk.\n\n## Documentation\n\nFor complete documentation, examples, and guides, see the [Documentation](https://githubnext.github.io/gh-aw/).\n\n## Contributing\n\nWe welcome contributions to GitHub Agentic Workflows! Here's how you can help:\n\n- **Report bugs and request features** by filing issues in this repository\n- **Improve documentation** by contributing to our docs\n- **Contribute code** by following our [Development Guide](DEVGUIDE.md)\n  - **Quick Start**: See [Common Development Tasks](DEVGUIDE.md#common-development-tasks) for scenario-based command reference\n- **Share ideas** in the `#continuous-ai` channel in the [GitHub Next Discord](https://gh.io/next-discord)\n\nFor development setup and contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Share Feedback\n\nWe welcome your feedback on GitHub Agentic Workflows! Please file bugs and feature requests as issues in this repository,\nand share your thoughts in the `#continuous-ai` channel in the [GitHub Next Discord](https://gh.io/next-discord).\n\n## Peli's Agent Factory\n\nSee the [Peli's Agent Factory](https://githubnext.github.io/gh-aw/blog/2026-01-12-welcome-to-pelis-agent-factory/) for a guided tour through many uses of agentic workflows.\n\n## Related Projects\n\nGitHub Agentic Workflows is supported by companion projects that provide additional security and integration capabilities:\n\n- **[Agent Workflow Firewall (AWF)](https://github.com/githubnext/gh-aw-firewall)** - Network egress control for AI agents, providing domain-based access controls and activity logging for secure workflow execution\n- **[MCP Gateway](https://github.com/githubnext/gh-aw-mcpg)** - Routes Model Context Protocol (MCP) server calls through a unified HTTP gateway for centralized access management\n- **[The Agentics](https://github.com/githubnext/agentics)** - A collection of reusable agentic workflow components, tools, and templates to accelerate workflow development\n\n---\n\n\u003e [!TIP]\n\u003e **For AI Agents**: To learn about GitHub Agentic Workflows syntax, file formats, tools, and best practices, please read the comprehensive instructions at [.github/aw/github-agentic-workflows.md](.github/aw/github-agentic-workflows.md)\n\u003e\n\u003e **Repository Configuration**: To configure a repository for GitHub Agentic Workflows, follow the interactive setup wizard at [install.md](install.md)\n\u003e\n\u003e **Custom Agent**: Use the custom agent at [.github/agents/agentic-workflows.agent.md](.github/agents/agentic-workflows.agent.md) to interactively create agentic workflows.\n","funding_links":[],"categories":["⭐ Most Starred","Agentic Frameworks"],"sub_categories":["Continuous Security"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithubnext%2Fgh-aw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgithubnext%2Fgh-aw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithubnext%2Fgh-aw/lists"}