Documentation
title: Integrations description: Connect Cadence to Git platforms, AI providers, AI assistants, and automation workflows order: 3
Integrations
Cadence provides four integration surfaces: a webhook server for continuous Git platform monitoring, AI providers (OpenAI and Anthropic) for enhanced detection, an AI skills system for embedding detection into agents and pipelines, and a plugin API for extending detection with custom strategies.
Integration Surfaces
AI Providers
Connect Cadence to OpenAI or Anthropic to add AI-powered analysis on top of pattern-based detection. AI analysis runs after suspicious items are flagged, providing confidence scores, reasoning, and detailed indicators.
Best for:
- Deeper analysis of flagged commits with natural-language explanations
- Higher confidence scoring using LLM reasoning
- Report summarization and pattern explanation
Guides: Overview · Configuration · Examples
Webhook Server
Run Cadence as a long-running HTTP server that receives push events from GitHub or GitLab, queues analysis jobs, and returns results via REST or Server-Sent Events.
Best for:
- Continuous repository monitoring on every push
- CI/CD pipeline integration
- Self-hosted Git platforms (GitHub, GitLab, Gitea, Forgejo)
Guides: Overview · GitHub Setup · GitLab Setup · API Reference
Agent Skills
Cadence exposes four internal AI skills and two external skills (via skills.json) compatible with Claude, ChatGPT, and custom automation tools.
Best for:
- AI coding assistants invoking detection directly in conversation
- On-demand analysis without a running server
- Embedding detection results into automation pipelines
Guides: Overview · Internal Skills · External Skills
Analysis Plugins
Extend Cadence's detection pipeline by implementing the StrategyPlugin interface. Plugins register with the PluginManager and participate in all analysis runs.
Best for:
- Custom detection strategies unique to your codebase or policy
- Domain-specific heuristics not covered by built-in detectors
- Wrapping third-party analysis tools in the Cadence pipeline
Guides: Overview · Writing Plugins
Quick Start
Start the Webhook Server
cadence webhook --port 8000 --secret "your-webhook-secret"
Enable AI Analysis
export CADENCE_AI_ENABLED=true
export CADENCE_AI_PROVIDER=openai # or: anthropic
export CADENCE_AI_KEY=sk-...
cadence analyze /path/to/repo -o report.json --config .cadence.yaml
Run On-Demand Analysis via API
curl -X POST http://localhost:8000/api/analyze/repository \
-H "Content-Type: application/json" \
-d '{"url": "https://github.com/owner/repo", "branch": "main"}'