ci-channel AGENTS.md

Project instructions for a plugin that sends continuous-integration and continuous-delivery notifications into active Claude Code sessions. Continuous integration checks code changes automatically, while delivery workflows build or release software.

In plain words
What is it for?
Use it when changing the plugin’s MCP server, GitHub Actions, GitLab CI, or Gitea Actions integrations, configuration loading, or related tests and documentation.
Why use it?
It gives coding agents the project’s layout, configuration rules, and implementation references so they can work consistently on the notification plugin.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/cluesmith/ci-channel/agents-md
Clone the repo
git clone --depth 1 https://github.com/cluesmith/ci-channel

Made for: Codex, OpenCode.

Per session 1,697 This file is loaded in full into every session.
When invoked 1,697 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01697 $0.01697
Opus 5 $0.00848 $0.00848
Sonnet 5 $0.00339 $0.00339
Haiku 4.5 $0.00170 $0.00170

Measured 3d ago against content hash 214121056087, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ci-channel AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 119 lines

How it starts

The opening of the file, as written. The whole thing — 119 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ci-channel - AI Agent Instructions

Note: This file follows the AGENTS.md standard for cross-tool compatibility with Cursor, GitHub Copilot, and other AI coding assistants. A Claude Code-specific version is maintained in CLAUDE.md.

Project Overview

A Claude Code channel plugin that delivers real-time CI/CD notifications into running Claude Code sessions. Supports GitHub Actions, GitLab CI, and Gitea Actions. Built with the MCP (Model Context Protocol) SDK and published on npm as ci-channel.

This project uses Codev for AI-assisted development.

Architecture

See codev/resources/arch.md for the full architecture document.

Key components:

  • server.ts — MCP server entry point + setup subcommand dispatch
  • lib/forge.ts — Forge interface (strategy pattern for multi-forge support)
  • lib/forges/github.ts — GitHub Actions forge (HMAC-SHA256, workflow_run, gh CLI)
  • lib/forges/gitlab.ts — GitLab CI forge (token validation, Pipeline Hook, glab CLI)
  • lib/forges/gitea.ts — Gitea Actions forge (HMAC-SHA256, workflow_run, fetch API)
  • lib/config.ts — Configuration loading (CLI args + env vars + .env file)
  • lib/bootstrap.ts — First-run auto-provisioning (secret generation, smee channel, setup notification)
  • lib/handler.ts — Webhook handler pipeline (validate → dedup → filter → notify)
  • lib/webhook.ts — Signature validation, event parsing, deduplication
  • lib/notify.ts — Notification formatting and sanitization
  • lib/reconcile.ts — Startup reconciliation and job enrichment
  • lib/project-root.ts — Walk-up project root detection (.mcp.json / .git)
  • lib/state.ts — Plugin state persistence (state.json read/write)
  • lib/setup.tsci-channel setup installer — supports all three forges and Codev auto-integration (Spec 5 + Spec 7, ≤300 lines, single file, no DI)

Configuration

State is project-scoped as of v0.2.0. Each project gets its own <project-root>/.claude/channels/ci/state.json and <project-root>/.claude/channels/ci/.env. Project root is detected via findProjectRoot() (walks up for .mcp.json or .git/).

Read the full file on GitHub · 119 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 119 lines · 1,697 tokens per session scan A 214121056087

Subscribe to this mod's changes

ci-channel AGENTS.md is an instructions file published in the GitHub repository cluesmith/ci-channel (4 stars, last pushed 4mo ago), licensed MIT. It adds 1,697 tokens to every session, about $0.0085 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.