github-watcher

An agent-awareness provider plugin that monitors GitHub repositories for new issues, PRs, and comments from external users.

Features

• Delta-only reporting — tracks state per repo, only reports new activity since last check
• External-only filtering — ignore specific users like your own account or bots (ignoreAuthors)
• Parallel fetching — checks all repos concurrently
• Compact + detailed formats — compact for intervals, detailed for session start
• Zero token waste — silent when nothing new (onlyWhenNew: true)

Installation

npm install -g agent-awareness-plugin-github-watcher

The agent-awareness loader auto-discovers agent-awareness-plugin-* packages from both global and local node_modules/.

Triggers

| Trigger | Default | Description | |---------|---------|-------------| | session-start | detailed | Full breakdown of new issues, PRs, and comments at session start | | interval:15m | compact | One-liner summary every 15 minutes, silent when nothing new |

Configuration

Create ~/.config/agent-awareness/plugins.d/github-watcher.json:

{
  "enabled": true,
  "repos": [
    "owner/repo1",
    "owner/repo2"
  ],
  "ignoreAuthors": ["your-github-username", "dependabot[bot]"],
  "issueLimit": 50,
  "prLimit": 50,
  "commentLimit": 10,
  "onlyWhenNew": true,
  "triggers": {
    "session-start": "detailed",
    "interval:15m": "compact"
  }
}

Config options

| Option | Type | Default | Description | |--------|------|---------|-------------| | repos | string[] | [] | Repos to watch (owner/repo format) | | ignoreAuthors | string[] | [] | GitHub usernames to filter out | | issueLimit | number | 50 | Max issues fetched per repo per check | | prLimit | number | 50 | Max PRs fetched per repo per check | | commentLimit | number | 10 | Max comments per repo per check | | format | string | "auto" | Output format: compact, detailed, or auto | | onlyWhenNew | boolean | true | Only inject when there's new activity | | focusCurrentRepo | boolean | true | Prioritize current session's repo when it matches a watched repo |

Trigger formats

Trigger values can be true/false or a format string ("compact" / "detailed"):

• "session-start": "detailed" — full breakdown at session start
• "interval:15m": "compact" — one-liner every 15 minutes

Output examples

Compact:

GitHub: edimuj/tokenlean: 1 new issue, 2 new comments | edimuj/claude-rig: 1 new PR

Detailed:

GitHub activity:
**edimuj/tokenlean**
  📋 #42 Bug: CLI crashes on empty input (by @contributor)
  💬 #38 @reviewer: Looks good to me! Just one small nit on line 42…
**edimuj/claude-rig**
  🔀 #15 Add fish shell support (by @community-dev)

Requirements

• gh CLI installed and authenticated
• agent-awareness v0.4.0+

License

MIT