Feature Request: Real-time Suggestions API/Webhook System

[jdrhyne]

Feature Request: Real-time Suggestions API/Webhook System

Problem Statement

Currently, claude-code-github provides intelligent suggestions and monitoring insights, but these are only accessible through the MCP interface when interacting with Claude. This limits the ability for external tools and integrations to benefit from the intelligent monitoring capabilities.

Use Case

As a developer building tools that complement claude-code-github (like AgentCopy), I need programmatic access to:

• Real-time monitoring status
• Intelligent suggestions (protected branch warnings, commit timing, etc.)
• Development pattern insights
• Workflow recommendations

Proposed Solution

Implement a real-time API or webhook system that allows external applications to:

1. REST API Endpoints:

   GET /api/projects/{project_path}/suggestions
   GET /api/projects/{project_path}/monitoring-status
   GET /api/projects/{project_path}/events
   POST /api/webhooks/subscribe
   

2. Webhook Events:

   • suggestion.created - When a new suggestion is generated
   • monitoring.status_changed - When monitoring starts/stops
   • pattern.detected - When a development pattern is recognized
   • threshold.reached - When configured thresholds are hit

3. WebSocket Support:

   • Real-time streaming of suggestions and events
   • Bidirectional communication for interactive features

Example API Response

{
  "project": "/Users/admin/Projects/AgentCopy",
  "suggestions": [
    {
      "id": "protected-branch-warning",
      "type": "warning",
      "priority": "high",
      "message": "Working on protected branch 'main'",
      "recommendation": "Create feature branch",
      "context": {
        "current_branch": "main",
        "modified_files": 4
      }
    },
    {
      "id": "commit-timing",
      "type": "suggestion",
      "priority": "medium",
      "message": "4 files modified - good time to commit",
      "recommendation": "Commit related changes together"
    }
  ],
  "monitoring": {
    "active": true,
    "duration_minutes": 45,
    "events_captured": 12
  }
}

Benefits

1. Integration Opportunities: Other tools can consume and display suggestions
2. Automation: CI/CD pipelines could react to suggestions
3. Custom Dashboards: Teams can build monitoring dashboards
4. Cross-tool Workflows: Better integration between development tools

Implementation Considerations

• Authentication via API keys or OAuth
• Rate limiting to prevent abuse
• Configurable webhook URLs per project
• Optional filtering of suggestion types

Additional Context

This feature would enable tools like AgentCopy to display claude-code-github's intelligent suggestions directly in their UI, creating a more seamless development experience without requiring developers to interact through the MCP interface for every insight.

Would love to discuss implementation details or contribute to this feature!

[jdrhyne]

Thank you for this excellent feature request! Here's an update on the current status:

Status Update

This feature was partially attempted in PR #33 but was closed without merging due to architectural concerns about adding too many features to the core MCP server package.

What's Currently Available:

• ✅ Core monitoring and suggestion generation - The underlying system exists and works well
• ✅ Agent monitoring dashboard - PR feat: add agent monitoring system with real-time dashboards and CI fixes #39 added real-time visualization
• ❌ REST API endpoints - Not yet implemented
• ❌ WebSocket server - Not yet implemented
• ❌ Webhook system - Not yet implemented

Architectural Decision:

The maintainer decided to keep the MCP server focused on its core responsibility and suggested implementing these features as separate packages:

• claude-code-api - REST API server
• claude-code-desktop - Desktop notifications
• claude-code-dashboard - Terminal dashboard (this part is now complete)

Workaround Options:

1. Use the monitoring dashboard - You can observe suggestions in real-time
2. Fork and extend - The codebase has all the hooks needed to add API endpoints
3. Direct integration - Import the package as a library and access the suggestion engine directly

Future Plans:

This remains a valid feature request. The API/webhook functionality would be valuable for integrations like AgentCopy. It may be implemented as a separate companion package that works alongside the main MCP server.

I'll keep this issue open to track interest and potentially implement it in a future release following the modular architecture approach.