check | list | research | synthesize | stats [options]
Tracks Anthropic repository updates with research state management to maintain dependency awareness.
/plugin marketplace add jrc1883/popkit-claude/plugin install popkit-core@popkit-claude<subcommand> [options]Track Anthropic repository updates (Claude Code, official plugins, SDKs) with research state management - essentially a "dependabot for Claude Code."
Manually tracking which Anthropic changelog items have been researched becomes "muddy and confusing":
Automated tracking with status lifecycle: pending_research ā researched ā synthesized
| Subcommand | Description |
|---|---|
| check | Check monitored repos for new updates |
| list | List changelog items by status |
| research | Research a specific item with guided flow |
| synthesize | Mark item as integrated, link issues/PRs |
| stats | Show tracking statistics and velocity |
Check all monitored repositories for new updates since last check.
.claude/popkit/upstream-tracking.jsongh api repos/{owner}/{repo}/releasesgh api repos/{owner}/{repo}/commits (main branch, since last check)pending_researchš Checking Anthropic repositories for updates...
anthropics/claude-code
ā Latest: v2.1.0 (released 2026-01-25)
š 1 new item found:
- Enhanced hook system (2026-01-20)
anthropics/claude-plugins-official
ā Up to date
š 2 new items found:
- feature-dev: New template system (2026-01-29)
- debugging: Added trace visualization (2026-01-27)
anthropics/anthropic-sdk-python
ā Latest: v0.42.0 (released 2026-01-28)
anthropics/anthropic-sdk-typescript
ā Latest: v0.42.0 (released 2026-01-28)
Summary: 3 new items need research
Last checked: 2026-01-31T10:30:00Z
| Flag | Description |
|---|---|
| --brief | One-line summary for routines |
| --json | Machine-readable JSON output |
| --verbose | Show detailed discovery process |
š Anthropic Updates: 3 items need research
List tracked changelog items filtered by status.
/popkit-core:upstream list # All items
/popkit-core:upstream list pending # Need research
/popkit-core:upstream list researched # Researched
/popkit-core:upstream list synthesized # Integrated
š Upstream Tracking Status
Pending Research (3 items):
[claude-code-hooks] Enhanced hook system
Discovered: 2026-01-20
URL: https://github.com/anthropics/claude-code/commit/abc123
[feature-dev-templates] New template system
Discovered: 2026-01-29
URL: https://github.com/anthropics/claude-plugins-official/commits/main
[debugging-trace] Added trace visualization
Discovered: 2026-01-27
URL: https://github.com/anthropics/claude-plugins-official/commits/main
Researched (2 items):
[claude-code-v2.1.0] Claude Code v2.1.0
Impact: none - MCP improvements don't affect PopKit
Research Date: 2026-01-26
[code-review-confidence] code-review: Confidence scoring
Impact: alignment - PopKit's 80+ threshold aligns well
Research Date: 2026-01-28
Synthesized (1 item):
[code-review-confidence] code-review: Confidence scoring
Impact: alignment
Related: Issue #213, PR #214
Notes: Updated CLAUDE.md integration docs
| Flag | Description |
|---|---|
| --json | Machine-readable output |
| --repo | Filter by repository |
Guided workflow to research a specific changelog item.
/popkit-core:upstream research <item-id>
Fetch Details
Research Prompts
Impact Assessment
Action Decision
upstream-tracking labelUpdate Status
researchedš Researching: Enhanced hook system
ID: claude-code-hooks
Repository: anthropics/claude-code
Discovered: 2026-01-20T00:00:00Z
URL: https://github.com/anthropics/claude-code/commit/abc123
Opening URL in browser... (or fetching with WebFetch)
Research Summary:
> (User input) Claude Code v2.0.5 added new hook types for
> pre-tool and post-tool events. This could enhance PopKit's
> measurement and debugging capabilities.
PopKit Impact Assessment:
1. critical - Breaking changes
2. high - Significant enhancement
3. medium - Worth considering
4. low - Minor update
5. none - No impact
6. alignment - Confirms approach
Choose impact (1-6): 2
Should we create a GitHub issue to track this? (y/n): y
Issue Title: Explore new hook types in Claude Code v2.0.5
Issue Created: #219
URL: https://github.com/jrc1883/popkit-claude/issues/219
ā
Research Complete
Status: pending_research ā researched
Impact: high
Related: Issue #219
Mark a researched item as synthesized and link to PopKit issues/PRs.
/popkit-core:upstream synthesize <item-id> \
--issues #213,#214 \
--prs #215 \
--notes "Updated CLAUDE.md integration docs"
researched (can't synthesize pending items)synthesizedā
Item Synthesized
[code-review-confidence] code-review: Confidence scoring
Status: researched ā synthesized
Related Issues: #213, #214
Related PRs: #215
Notes: Updated CLAUDE.md integration docs
Thank you for completing the research cycle!
| Flag | Description |
|---|---|
| --issues | Comma-separated issue numbers |
| --prs | Comma-separated PR numbers |
| --notes | Integration notes |
Show upstream tracking statistics and research velocity.
š Upstream Tracking Statistics
Total Items Tracked: 15
āā Pending Research: 3 (20%)
āā Researched: 8 (53%)
āā Synthesized: 4 (27%)
Impact Distribution:
āā Critical: 0
āā High: 2
āā Medium: 5
āā Low: 3
āā None: 5
Research Velocity:
āā Average research time: 2.5 days
āā Items researched this week: 3
āā Items synthesized this month: 7
Last Repository Check: 2 hours ago
Next Scheduled Check: In 22 hours (daily)
| Flag | Description |
|---|---|
| --json | Machine-readable JSON output |
| --repo | Filter by repository |
Storage: .claude/popkit/upstream-tracking.json
{
"repositories": {
"anthropics/claude-code": {
"last_checked": "2026-01-31T10:30:00Z",
"latest_release": "v2.1.0",
"changelog_items": [
{
"id": "claude-code-v2.1.0",
"type": "release",
"title": "Claude Code v2.1.0",
"url": "https://github.com/anthropics/claude-code/releases/tag/v2.1.0",
"published_date": "2026-01-25T00:00:00Z",
"discovered_date": "2026-01-31T10:30:00Z",
"status": "researched",
"research_summary": "Added new MCP features. No PopKit integration needed.",
"research_date": "2026-01-26T00:00:00Z",
"popkit_impact": "none",
"related_issues": [],
"related_prs": [],
"notes": "MCP improvements don't affect PopKit's CLI-based approach"
}
]
}
},
"settings": {
"check_frequency_hours": 24,
"auto_check_in_morning_routine": true,
"notification_threshold": "all"
},
"statistics": {
"total_items_tracked": 15,
"pending_research": 3,
"researched": 8,
"synthesized": 4,
"avg_research_time_days": 2.5
}
}
Add to /popkit-dev:routine morning:
- id: check_upstream
description: Check for Anthropic updates
type: command
command: /popkit-core:upstream check --brief
optional: true
settings_key: check_upstream_in_morning
User can disable with:
/popkit-dev:routine morning --no-upstream
| Component | Location | Purpose |
|---|---|---|
| Command Definition | commands/upstream.md | This file |
| Tracking Utility | hooks/utils/upstream_tracker.py | Core tracking logic |
| Data Storage | .claude/popkit/upstream-tracking.json | Persistent state |
| Morning Integration | commands/routine.md | Auto-check support |
Related:
/popkit-dev:routine morning - Integrated auto-check/popkit-core:stats - Similar statistics pattern/popkit-dev:issue - Issue creation pattern# Morning: Check for updates
/popkit-dev:routine morning
# Output includes: š Anthropic Updates: 3 items need research
# List pending items
/popkit-core:upstream list pending
# Research an item
/popkit-core:upstream research claude-code-hooks
# (Interactive guided workflow)
# After creating issue and implementing
/popkit-core:upstream synthesize claude-code-hooks \
--issues #219 \
--notes "Implemented new hook integration"
# See overall statistics
/popkit-core:upstream stats
# Review all researched items
/popkit-core:upstream list researched
# Export for reporting (JSON)
/popkit-core:upstream stats --json > upstream-report.json