ccc-ci

$ccc-ci — CI/CD Webhook Channel

Bridges your CI/CD pipeline to your active Claude Code session. Deploy events arrive in real time; failures trigger automatic diagnosis; successes get celebrated.

What it does

$ccc-ci runs a lightweight HTTP receiver on localhost:7891 that accepts signed webhook payloads from GitHub Actions, Vercel, Railway, and Fly.io. Each inbound event is classified, routed to a handler, and surfaced in chat — so you see deploy failures, test results, and approval gates without leaving your session. On failure, CCC automatically loads $ccc-doctor, reads the CI log, classifies the error, and proposes a concrete fix. On success, it drafts a celebration tweet you can post with one click.

Setup

# 1. Start the local receiver (default port 7891)
$ccc-ci init

# 2. (Optional) pick a different port
$ccc-ci init --port 8321

# 3. Expose publicly if your CI provider can't reach localhost
$ccc-ci init --tunnel   # wraps with ngrok or cloudflared

init prints a webhook URL, copies it to clipboard, and emits ready-to-paste configs for each supported provider.

GitHub Actions — paste into your workflow YAML

- name: Notify CCC
  if: always()
  run: |
    curl -s -X POST ${{ secrets.CCC_WEBHOOK_URL }} \
      -H "X-CCC-Signature: $(echo -n '${{ toJSON(github.event) }}' | openssl dgst -sha256 -hmac '${{ secrets.CCC_SECRET }}' | awk '{print $2}')" \
      -H "Content-Type: application/json" \
      -d '{"event":"${{ job.status == 'success' && 'deploy_succeeded' || 'deploy_failed' }}","ref":"${{ github.ref }}","run_url":"${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"}'

Vercel — Dashboard → Settings → Webhooks → Add

Point to the URL printed by $ccc-ci init. Select: deployment.created, deployment.succeeded, deployment.error.

Fly.io — fly webhooks create

fly webhooks create --app myapp \
  --url "$(pbpaste)" \
  --events instance_state_change

Supported Events