github/gh-aw

AWF Release Integrator upgrades gh-aw to the latest gh-aw-firewall release, bumps version constants, rebuilds generated artifacts, and reviews upstream spec changes to identify follow-up tasks.

Agent Session CLI uses the gh agent-session command to inspect and manage GitHub Copilot coding agent sessions, including creating tasks from natural language instructions, listing, viewing, and updating them.

Agent Task CLI creates GitHub Copilot coding agent tasks from the command line, using natural language instructions that trigger automated code changes and pull requests. Use it to delegate coding work, list and view tasks, and integrate with GitHub Agentic Workflows.

Agentic Workflows compiles Markdown-defined AI agent jobs into GitHub Actions, so developers can define AI-powered repository automation and run AI agents securely through GitHub Actions for reasoning tasks.

Agentic Workflows Router dispatches user requests to design, create, update, debug, or upgrade GitHub Agentic Workflows to the correct internal prompt or skill file. Use it when working on agentic workflows in a repository, and follow the matched instructions directly.

Checkout Credential Review helps review code that performs git or gh operations against repository checkouts, ensuring the right credentials are available at the right time and that sparseness, shallowness, and credential-free factors are considered.

Console Rendering uses Go struct tags to render styled terminal output in the gh-aw CLI, controlling headers, formatting (number, cost), omitempty, and table generation for structs, slices, and maps.

Copilot Agent Tips and Tricks provides practical guidance for finding, reviewing, and managing pull requests created by Copilot coding agents, including gh CLI commands, search patterns, and best practices for reviewing AI-generated code.

Copilot Review instructs Copilot to collect, filter, bucket, and respond to pull request review feedback from trusted reviewers and automation. Use it when addressing review comments or summaries on a pull request.

Create Canvas authors, validates, and debugs canvas extensions that agents open in the Copilot app side panel. Use it when creating, reviewing, or troubleshooting a canvas extension, including its actions, inputs, rendered content, and extension wiring.

Custom Agents defines and validates GitHub custom agent files, prompts, and examples. Use it to create agent profiles, path-specific instructions, and workflow-specific agent configurations.

Debugging Workflows uses gh aw logs and gh aw audit to download and analyze GitHub Actions run logs, detect errors, and trace agentic workflow behavior for failure triage.

Developer Code Organization provides patterns for organizing Go code, including file structure, file size guidelines, test organization, and string sanitization/normalization conventions. Use this reference when working in the gh-aw codebase to keep files small and maintainable.

Developer Release documents release management procedures, changeset-based releases, firewall log parsing, breaking CLI change rules, and Go module summaries for gh-aw. Use it when maintaining releases, analyzing firewall logs, or understanding CLI stability constraints.

Developer Security provides security guidelines for gh-aw workflows and Go code, covering template injection prevention, shell script security, supply chain hardening, and static analysis integration.

Discussion Query fetches GitHub discussions from a repository and filters them with jq expressions. Use it to inspect discussion schema, retrieve all data, or run targeted queries like unanswered posts or counts by category.

Documentation provides guidance for writing concise Diátaxis docs for gh-aw with Starlight markdown conventions. Use it when authoring tutorials, how-to guides, reference, and explanation pages.

Error Messages defines a template and guidelines for writing clear, actionable validation error messages in the gh-aw codebase. Use it when creating or reviewing error messages to ensure they state the problem, expected format, and an example fix.

Error Pattern Safety provides rules for writing safe regular expressions that prevent JavaScript infinite loops in agentic engines.

Error Recovery Patterns provides guidance for implementing retry logic, circuit breakers, exponential backoff, error categorization, and debug logging to reduce retry loops and handle transient failures in automated agent workflows. Use it when adding recovery strategies for network operations, installations, or API calls.

GH-AW Developer provides core rules and coding conventions for making changes to gh-aw, including validation checkpoints, capitalization rules, and lazy-loading sub-skills.

GH-AW Developer Internals documents the internal architecture of the gh-aw compiler, including validation system design, safe output message patterns, schema validation, YAML compatibility notes, and the MCP logs guardrail. Use it when maintaining or extending gh-aw internals, validation logic, safe output processing, or MCP server features.

Issue Query retrieves GitHub issues and filters them with jq expressions. Use it to inspect issue data without overwhelming output, and run targeted queries by state, author, labels, and more.

Labels Query lists GitHub repository labels with per_page pagination and name filtering support. Use it to query labels from any GitHub repository with controlled page sizes and case-insensitive name filtering.

Playwright CLI automates browser interactions and tests web pages via a command-line interface. Use it to navigate, click, type, inspect snapshots, manage cookies and storage, mock network requests, and debug with console and tracing.