|
1 | | -# gh-aw Ecosystem Knowledge Base |
| 1 | +# gh-aw Knowledge Base |
2 | 2 |
|
3 | | -> Persistent, append-only log of stable facts about the GitHub Agentic Workflows ecosystem. |
4 | | -> Updated by `/aw-report` runs. Each entry is timestamped and categorized. |
5 | | -> Do NOT delete entries — mark superseded facts with `[SUPERSEDED by YYYY-MM-DD]`. |
| 3 | +> Persistent cross-session facts about the GitHub Agentic Workflows ecosystem. |
| 4 | +> Updated by each run of the gh-aw-report skill. Entries are dated and append-only. |
| 5 | +> Do not remove entries — mark superseded information with `[SUPERSEDED by YYYY-MM-DD]`. |
6 | 6 |
|
7 | | -## Format |
| 7 | +--- |
8 | 8 |
|
9 | | -Each entry follows: |
10 | | -``` |
11 | | -### YYYY-MM-DD — Category — Title |
12 | | -Content |
13 | | -``` |
| 9 | +## [2026-04-14] Bootstrap Entry — Initial Research |
14 | 10 |
|
15 | | -Categories: `version`, `deprecation`, `breaking-change`, `architecture`, `ecosystem`, `security`, `feature` |
| 11 | +### gh-aw CLI |
| 12 | +- **Technical preview launched**: February 13, 2026 |
| 13 | +- **Core repo**: `github/gh-aw` (github.com/github/gh-aw) |
| 14 | +- **Docs**: github.github.com/gh-aw/ |
| 15 | +- **GitHub Next page**: githubnext.com/projects/agentic-workflows/ |
| 16 | +- **Default agent**: GitHub Copilot CLI |
| 17 | +- **Alternative agents**: Claude (Anthropic), Codex (OpenAI) |
| 18 | +- **Key CLI commands**: `gh aw compile`, `gh aw run`, `gh aw fix --write`, `gh aw upgrade` |
| 19 | +- **Issue #10193**: Intermittent Daily News workflow failures (~40% success rate, flagged Feb 2026) |
| 20 | +- **MCP updates tracked in gh-aw**: Issue #20042 tracks GitHub MCP Server v0.31.0→v0.32.0 and MCP Gateway v0.1.8→v0.1.9 |
16 | 21 |
|
17 | | ---- |
| 22 | +### Breaking Changes / Deprecations ACTIVE as of 2026-04-14 |
| 23 | +| Item | Status | Migration | Date | |
| 24 | +|------|--------|-----------|------| |
| 25 | +| `plugins:` frontmatter field | **DEPRECATED** | Use `dependencies:` field; run `gh aw fix --write` | Early 2026 | |
| 26 | +| npm `@modelcontextprotocol/server-github` | **DEPRECATED** | Use Docker or HTTP GitHub MCP Server | April 2025 | |
| 27 | +| actions/cache v1-v2 | **REMOVED** | Use v3 or v4 | March 2025 | |
| 28 | +| Workflow prompt files managed by CLI | **CHANGED** | Files now resolved from gh-aw repo directly | 2026 | |
| 29 | + |
| 30 | +### GitHub Actions (as of 2026-04-14) |
| 31 | +- Immutable Actions in general use for hosted runners |
| 32 | +- Self-hosted runners must allow `pkg.actions.githubusercontent.com` |
| 33 | +- Pricing backlash/changes tracked at samexpert.com (check for current state) |
| 34 | + |
| 35 | +### GitHub MCP Server (as of 2026-04-14) |
| 36 | +- **Official repo**: `github/github-mcp-server` |
| 37 | +- **Container**: `ghcr.io/github/github-mcp-server` |
| 38 | +- ~~npm `@modelcontextprotocol/server-github`~~ DEPRECATED April 2025 |
| 39 | +- **Insiders mode**: opt-in via `/insiders` URL or config header for experimental features |
| 40 | +- **HTTP mode**: enterprise deployment with per-request OAuth token support |
| 41 | +- **Projects toolset**: consolidated — saves ~23,000 tokens (~50% reduction) |
| 42 | +- **New tools**: `get_copilot_job_status`, `assign_copilot_to_issue`, `create_pull_request_with_copilot` |
| 43 | +- **`base_ref` parameter**: added to Copilot PR tools for stacked PRs / feature branches |
| 44 | +- **Changelog entry**: 2026-01-28 — New Projects tools, OAuth scope filtering |
| 45 | + |
| 46 | +### GitHub Copilot CLI (as of 2026-04-14) |
| 47 | +- **GA date**: February 25, 2026 (after ~5 months of public preview from September 2025) |
| 48 | +- **Available to**: All paid Copilot subscribers (Pro, Business, Enterprise) |
| 49 | +- **Modes**: Plan mode (shows plan first), Autopilot mode (fully autonomous) |
| 50 | +- **Background delegation**: prefix prompt with `&` to send to cloud coding agent |
| 51 | +- **Sub-agents**: Explore (codebase analysis), Task (build/test), Code Review, Plan |
| 52 | +- **Models**: Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.3-Codex, Gemini 3 Pro |
| 53 | +- **January 2026 changelog**: Enhanced agents, context management, new install methods |
18 | 54 |
|
19 | | -## Entries |
| 55 | +### GitHub Copilot Workspace / Agent Mode (as of 2026-04-14) |
| 56 | +- **JetBrains GA**: March 11, 2026 (VS Code was earlier) |
| 57 | +- **Waitlist removed**: Pro, Business, Enterprise — early 2026 |
| 58 | +- **Agentic code review GA**: March 2026 — full context → suggestions → auto-spawn fix PR |
| 59 | +- **Issue assignment**: Assign GitHub issue to Copilot → autonomous PR creation |
| 60 | +- **Instruction files read**: `CLAUDE.md`, `AGENTS.md`, `COPILOT.md`, custom instruction files, workspace and global scope |
| 61 | +- **Custom agents GA** (+ plan agent, sub-agents): GA; **agent hooks**: preview; **auto-approve MCP**: supported |
| 62 | +- **April 2026 changelog**: Copilot in Visual Studio — March update (released 2026-04-02) |
20 | 63 |
|
21 | | -<!-- New entries are appended above this line by the gh-aw-report skill --> |
| 64 | +### Claude Code / Anthropic GitHub Integration (as of 2026-04-14) |
| 65 | +- GitHub MCP Server installation guide for Claude: `github/github-mcp-server/docs/installation-guides/install-claude.md` |
| 66 | +- Claude Code connects to GitHub MCP Server via `claude mcp add-json github` (HTTP) or Docker |
| 67 | +- `steipete/claude-code-mcp`: Claude Code as a one-shot MCP server ("agent in your agent") |
| 68 | +- Copilot natively reads `CLAUDE.md` instruction files in agentic workflows |
| 69 | +- Claude can serve as the AI agent in gh-aw workflows (alternative to Copilot CLI) |
| 70 | + |
| 71 | +### Community / Ecosystem (as of 2026-04-14) |
| 72 | +- `githubnext/awesome-continuous-ai`: Curated list of Continuous AI actions and frameworks |
| 73 | +- `githubnext/agentics`: Sample pack of gh-aw workflows (community starter kit) |
| 74 | +- `0GiS0/github-agentic-workflows`: Community implementation with Daily Status Report bot |
| 75 | +- HN thread on gh-aw preview: news.ycombinator.com/item?id=46934107 |
| 76 | +- GitHub blog post: "Continuous AI in practice: What developers can automate today" |
| 77 | +- InfoQ coverage: "GitHub Agentic Workflows Unleash AI-Driven Repository Automation" (Feb 2026) |
| 78 | +- April 2026: GitHub integrates AI for accessibility issue management and feedback triage |
| 79 | + |
| 80 | +### Architecture Notes (stable) |
| 81 | +- gh-aw is NOT a replacement for deterministic CI/CD — it augments it ("Continuous AI") |
| 82 | +- Workflows run in isolated containers with read-only repo access by default |
| 83 | +- AWF (Agent Workflow Firewall) restricts network egress |
| 84 | +- Safe Outputs subsystem handles write operations in separate permission-controlled jobs |
| 85 | +- Threat detection job runs per-workflow: prompt injection, credential leaks, malicious code |
| 86 | + |
| 87 | +--- |
| 88 | +<!-- Append new entries above this line, newest first --> |
0 commit comments