ci

ci — ɳSelf documentation.

CI Plugin

Continuous integration hooks: GitHub Actions and GitLab CI webhook receiver, build status reporting, PR check gates. Free: MIT licensed.

Install

nself plugin install ci

What It Does

Receives webhooks from GitHub Actions and GitLab CI pipelines, stores build status in Postgres, and exposes a status API. Supports PR check gates: your nSelf backend can block or approve pull requests based on custom logic tied to CI outcomes.

Use cases:

• Store build history for audit and reporting
• Trigger nSelf actions (notifications, deployments) on CI events
• Gate PR merges on backend validation results

Configuration

Env Var	Default	Description
CI_WEBHOOK_SECRET	(auto-generated)	HMAC secret for validating GitHub/GitLab webhook payloads
CI_GITHUB_APP_ID	none	GitHub App ID for check run updates (optional)
CI_GITHUB_APP_KEY	none	GitHub App private key base64 (optional)

Ports

No fixed external port. The CI webhook receiver is proxied through Nginx.

Database Tables

2 tables added to your Postgres database:

• np_ci_builds: build runs, status, and metadata
• np_ci_checks: PR check gate results

Nginx Routes

Method	Path	Purpose
POST	/ci/webhook/github	GitHub Actions webhook receiver
POST	/ci/webhook/gitlab	GitLab CI webhook receiver

Source

• SPORT: .claude/docs/sport/F03-PLUGIN-INVENTORY-FREE.md
• See also: Plugin Catalog · GitHub Plugin