CI/CD Integrations

Overview

Add push notifications and approval gates to any CI/CD pipeline. All zero-dependency and open-source.

CLI

Single-file shell tool. Works in any CI/CD, cron job, or terminal. Requires curl and jq.

Install

curl -fsSL https://raw.githubusercontent.com/qq418716640/botbell-cli/main/botbell -o /usr/local/bin/botbell
chmod +x /usr/local/bin/botbell
export BOTBELL_TOKEN="bt_your_token"

Send

botbell send "Deploy succeeded ✅"

Approval gate

botbell approve "Deploy to production?" --timeout 300

GitHub Action

Add BotBell notifications and approval gates to any GitHub workflow.

Notify on build result

workflow.yml

- uses: botbell/notify-action@v1
  with:
    token: ${{ secrets.BOTBELL_TOKEN }}
    title: "✅ Build Passed"
    message: "#${{ github.run_number }} on ${{ github.ref_name }}"

Approval gate before deploy

workflow.yml

- uses: botbell/notify-action@v1
  with:
    token: ${{ secrets.BOTBELL_TOKEN }}
    mode: approve
    message: "Deploy #${{ github.run_number }} to production?"
    timeout: "1800"

Jenkins Shared Library

Add BotBell to Jenkins pipelines with two methods: notify and approve.

Setup: Add as a Global Pipeline Library pointing to the Git repo.

Jenkinsfile

@Library('botbell') _

pipeline {
    agent any
    environment {
        BOTBELL_TOKEN = credentials('botbell-token')
    }
    stages {
        stage('Deploy Approval') {
            steps {
                script {
                    botbell.approve(message: "Deploy to production?")
                }
            }
        }
    }
    post {
        success {
            script {
                botbell.notify(
                    title: "✅ Deploy Success",
                    message: "#${BUILD_NUMBER} deployed",
                )
            }
        }
    }
}