DEV Community

M Waleed Kadous
M Waleed Kadous

Posted on

CI Channel for Claude Channels CI notifications

Have you ever shipped code with Claude only to find out it didn’t make its way through your CI pipeline (it was stuck), but your AI didn’t do anything about it, and you only found out at the end of the day when you got an email?

CI Channel is a tool that uses the brand new Claude Code Channels feature to prevent that from happening. As soon as CI fails in your favorite forge ( GitHub, GitLab, Gitea), it sends a message to your Claude Code agent. It investigates the issue and can suggest a fix before you’ve even realized there’s a problem.

While most of the attention has gone to how to hook up agents to Discord, there are lots of cool, practical things you can do with channels.

The project was built using Codev OS, so it’s fully documented and tested. It’s a showcase of how our agentic architecture enables us to ship modular, high-impact tools that solve real developer friction points.

To use it, just do npx -y ci-channel setup --repo owner/project in your favorite Claude Code workspace.

CI Channel flow

GitHub logo cluesmith / ci-channel

Claude Code channel plugin for real-time CI/CD notifications (GitHub Actions, GitLab CI, Gitea)

CI Channel for Claude Code

Real-time CI/CD notifications delivered straight into your Claude Code session. When a CI workflow or pipeline fails, Claude sees it immediately and can investigate the failure, check logs, and suggest fixes — without you having to context-switch.

Supports GitHub Actions, GitLab CI, and Gitea Actions.

How It Works

Forge (GitHub/GitLab/Gitea)
        │
    webhook POST
        │
        ▼
   smee.io (relay)     ← auto-provisioned on first run
        │
        ▼
   localhost:{port}    ← random port, no conflicts
        │
        ▼
┌───────────────────┐
│  Channel Plugin   │  ← validates signature, deduplicates, filters
│   (MCP server)    │
└─────────┬─────────┘
          │
          ▼
┌───────────────────┐
│   Claude Code     │  ← receives structured notification
│    (session)      │
└───────────────────┘

Quick Start (One Command)

Run this from inside the project you want to monitor:

# GitHub (default)
cd /path/to/your-project
npx -y ci-channel setup --repo owner/your-project
# GitLab
npx -y ci-channel setup --forge gitlab --repo group/project

# Gitea (requires GITEA_TOKEN in
Enter fullscreen mode Exit fullscreen mode

Top comments (0)