Hooks #685

aaronpowell · 2026-02-09T06:04:57Z

This pull request adds support for "Hooks" as a new resource type in the Awesome GitHub Copilot repository, enabling automated workflows triggered by specific development events. The changes span documentation, code generation scripts, and website data processing, ensuring hooks are first-class citizens alongside agents, prompts, instructions, and skills.

- Introduced hooks to enable automated workflows triggered by specific events during GitHub Copilot sessions. - Added documentation for hooks in AGENTS.md and README.md. - Created a new directory structure for hooks, including README.md and hooks.json files. - Implemented two example hooks: Session Auto-Commit and Session Logger. - Developed scripts for logging session events and auto-committing changes. - Enhanced validation and parsing for hook metadata. - Updated build and validation scripts to accommodate new hooks functionality.

Copilot

Pull request overview

This PR introduces Hooks as a first-class resource type across the repo, including documentation generation, website data generation, and a new website page for browsing/downloading hook bundles.

Changes:

Adds hook folder examples under hooks/ (with README.md, hooks.json, and scripts).
Extends build/eng scripts to parse hook metadata and generate docs/README.hooks.md plus website/data/hooks.json.
Adds a Hooks landing page and homepage/nav integration in the website.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
website/src/scripts/utils.ts	Adds hook type detection/labels/icons.
website/src/scripts/pages/index.ts	Includes hooks in homepage manifest count rendering.
website/src/scripts/pages/hooks.ts	New Hooks listing page logic (filters/search/download ZIP).
website/src/pages/index.astro	Adds Hooks card to homepage.
website/src/pages/hooks.astro	New Hooks page markup (search/filters/list/modal).
website/src/layouts/BaseLayout.astro	Adds Hooks to top navigation.
hooks/session-logger/log-session-start.sh	New hook script for sessionStart logging.
hooks/session-logger/log-session-end.sh	New hook script for sessionEnd logging.
hooks/session-logger/log-prompt.sh	New hook script for userPromptSubmitted logging.
hooks/session-logger/hooks.json	Hook configuration mapping events to scripts.
hooks/session-logger/README.md	Documentation for the Session Logger hook.
hooks/session-auto-commit/hooks.json	Hook configuration for auto-commit on sessionEnd.
hooks/session-auto-commit/auto-commit.sh	Script to auto-commit/push at session end.
hooks/session-auto-commit/README.md	Documentation for the Session Auto-Commit hook.
eng/yaml-parser.mjs	Adds `parseHookMetadata()` for hook folders.
eng/validate-collections.mjs	Adds `hook` as a valid collection item kind (with validation).
eng/update-readme.mjs	Generates Hooks README section and writes `docs/README.hooks.md`.
eng/generate-website-data.mjs	Generates `hooks.json`, includes hooks in search index + manifest counts.
eng/constants.mjs	Adds hooks templates/dir/constants and install URL.
eng/collection-to-plugin.mjs	Adds hook support when converting collections to plugins.
docs/README.hooks.md	New generated Hooks catalog README.
README.md	Adds Hooks to top-level README navigation + overview text.
AGENTS.md	Documents Hooks as a repo resource type and contribution checklist.

Copilot · 2026-02-09T06:08:49Z

website/src/scripts/utils.ts

  if (filePath.includes("/skills/") && filePath.endsWith("SKILL.md"))
    return "skill";
+  if (filePath.includes("/hooks/") && filePath.endsWith("README.md"))
+    return "hook";


getResourceType() checks for filePath.includes("/hooks/"), but hook file paths generated for the website (and stored in the URL hash) are relative like hooks/<name>/README.md (no leading slash). This will classify hook deep links as unknown and break modal behavior for shared links. Consider matching on (^|/)hooks/ (and similarly for skills) rather than requiring a leading /.

@copilot open a new pull request to apply changes based on this feedback

eng/validate-collections.mjs

eng/collection-to-plugin.mjs

Copilot · 2026-02-09T06:08:50Z

eng/collection-to-plugin.mjs

+  // Hooks
+  const hooks = items.filter((item) => item.kind === "hook");
+  if (hooks.length > 0) {
+    lines.push("### Hooks");
+    lines.push("");
+    lines.push("| Hook | Description | Event |");
+    lines.push("|------|-------------|-------|");
+    for (const item of hooks) {
+      const name = getDisplayName(item.path, "hook");
+      const description =
+        item.frontmatter?.description || item.frontmatter?.name || name;
+      const event = item.frontmatter?.event || "N/A";
+      lines.push(`| \`${name}\` | ${description} | ${event} |`);
+    }
+    lines.push("");


The plugin README generator’s Hooks table uses frontmatter.event, but hook events in this PR are defined in hooks.json and the hook README frontmatter doesn’t include an event field. This will render N/A even when events exist. Consider extracting event names from hooks.json (similar to parseHookMetadata) when building the plugin README.

Copilot · 2026-02-09T06:08:51Z

AGENTS.md

@@ -48,9 +50,9 @@ npm run skill:create -- --name <skill-name>

 ## Development Workflow

-### Working with Agents, Prompts, Instructions, and Skills
+### Working with Agents, Prompts, Instructions, Skills, and Hooks

-All agent files (`*.agent.md`), prompt files (`*.prompt.md`), and instruction files (`*.instructions.md`) must include proper markdown front matter. Agent Skills are folders containing a `SKILL.md` file with frontmatter and optional bundled assets:
+All agent files (`*.agent.md`), prompt files (`*.prompt.md`), instruction files (`*.instructions.md`), and hook files (`*.hook.md`) must include proper markdown front matter. Agent Skills are folders containing a `SKILL.md` file with frontmatter and optional bundled assets:



This doc still describes hooks as .hook.md files (repository structure and frontmatter rules), but the implementation in this PR treats hooks as folders containing README.md + hooks.json. Please update the .hook.md references to match the folder-based hook format to avoid confusing contributors.

Copilot · 2026-02-09T06:08:51Z

hooks/session-logger/README.md

+This hook provides detailed logging of Copilot coding agent activity:
+- Session start/end times
+- User prompts and questions
+- Session duration
+- Working directory context
+
+## Features
+
+- **Complete Audit Trail**: Track all Copilot interactions
+- **Structured Logging**: JSON format for easy parsing
+- **Searchable History**: Review past sessions and prompts
+- **Analytics Ready**: Export data for usage analysis
+- **Privacy Aware**: Configurable to exclude sensitive data
+
+## Installation
+
+1. Copy this hook folder to your repository's `.github/hooks/` directory:
+   ```bash
+   cp -r hooks/session-logger .github/hooks/
+   ```
+
+2. Create the logs directory:
+   ```bash
+   mkdir -p logs/copilot
+   ```
+
+3. Ensure scripts are executable:
+   ```bash
+   chmod +x .github/hooks/session-logger/*.sh
+   ```
+
+4. Commit the hook configuration to your repository's default branch
+
+## Log Format
+
+Logs are written to `logs/copilot/session.log` in JSON format:
+
+```json
+{
+  "timestamp": "2024-01-15T10:30:00Z",
+  "event": "sessionStart",
+  "sessionId": "abc123",
+  "cwd": "/workspace/project"
+}
+```


The README claims the hook logs user prompts, session duration, and includes fields like sessionId in the JSON example, but the provided scripts currently only log timestamps/events (and don’t record prompt content, duration, or sessionId). Either update the scripts to capture these fields from the hook input, or adjust the README/features/example JSON to reflect what is actually logged.

hooks/session-logger/log-session-start.sh

eng/constants.mjs

eng/validate-collections.mjs

Copilot · 2026-02-10T03:28:45Z

@aaronpowell I've opened a new pull request, #691, to work on those changes. Once the pull request is ready, I'll request review from you.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

Fix path matching in getResourceType to handle relative paths

- Fix getResourceType() to match relative paths like hooks/<name>/README.md and skills/<name>/SKILL.md using regex instead of string includes - Extract hook events from hooks.json via parseHookMetadata() instead of non-existent frontmatter.event field in plugin README generation - Update AGENTS.md to describe hooks as folder-based (README.md + hooks.json) instead of .hook.md files - Update session-logger README to accurately reflect what scripts log (remove references to sessionId, duration, prompt content)

aaronpowell added 2 commits February 9, 2026 16:44

Adding hooks to the website

99a48a4

Copilot AI review requested due to automatic review settings February 9, 2026 06:04

Copilot started reviewing on behalf of aaronpowell February 9, 2026 06:05 View session

Copilot AI reviewed Feb 9, 2026

View reviewed changes

Initial plan

20806d3

Copilot AI mentioned this pull request Feb 10, 2026

Fix path matching in getResourceType to handle relative paths #691

Merged

13 tasks

aaronpowell and others added 5 commits February 10, 2026 14:28

Update eng/validate-collections.mjs

4ddc77b

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestions from code review

6210128

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Fix path matching in getResourceType to support relative paths

f62a764

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

Merge pull request #691 from github/copilot/sub-pr-685

a23d39a

Fix path matching in getResourceType to handle relative paths

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Hooks #685

Hooks #685

Uh oh!

aaronpowell commented Feb 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 9, 2026

Uh oh!

aaronpowell Feb 10, 2026

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 9, 2026

Uh oh!

Copilot AI Feb 9, 2026

Uh oh!

Copilot AI Feb 9, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Hooks #685

Are you sure you want to change the base?

Hooks #685

Uh oh!

Conversation

aaronpowell commented Feb 9, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

aaronpowell Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants