Skip to content

nerve-ink/nerveops-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

NerveOps GitHub Action

Send encrypted CI/CD signals from GitHub Actions to NerveOps.

Website · App Store · Google Play · CLI

This action is a thin wrapper around nerve send. It installs the public Nerve CLI, encrypts the message locally with your sender DSN, and sends ciphertext to the Nerve relay.

Start with failure alerts

  1. Install NerveOps from the App Store or Google Play.
  2. Create a pipe in the NerveOps app.
  3. Open pipe setup.
  4. Copy the sender DSN.
  5. Store it as a repository or organization secret named NERVE_DSN.
  6. Add this step after your build/test/deploy steps:
- name: Notify NerveOps on failure
  if: failure()
  uses: nerve-ink/nerveops-action@v1
  with:
    dsn: ${{ secrets.NERVE_DSN }}
    title: CI failed
    severity: critical
    message: |
      FAILED: ${{ github.repository }}
      ref: ${{ github.ref_name }}
      sha: ${{ github.sha }}
      run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

Deploy notification

- name: Notify NerveOps
  uses: nerve-ink/nerveops-action@v1
  with:
    dsn: ${{ secrets.NERVE_DSN }}
    title: Backend Deploy
    severity: standard
    message: |
      deploy ${{ job.status }}
      repo: ${{ github.repository }}
      sha: ${{ github.sha }}
      run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

Inputs

Input Required Default Description
dsn yes Sender DSN copied from the NerveOps app. Use a GitHub secret.
message no GitHub Actions summary Signal body. Keep it short.
title no GitHub Actions Short title shown in NerveOps clients.
severity no standard standard, alert, or critical.
kind no alert Signal kind metadata.
install-url no https://nerve.ink/install.sh Nerve CLI installer URL.

Security boundary

Use a sender DSN for GitHub Actions. A sender DSN can send into one pipe, but it cannot read history, decrypt content, connect as an agent, or execute commands.

Do not send full logs or secrets. Send short operational context: repository, branch/environment, status, commit SHA, and run URL.

When not to use this action

Do not use this action as a monitoring platform, chat system, or remote command runner. It is for one-way encrypted operational signals.

For signed actions on a machine you control, use nerve-agent explicitly.

Releases

Packages

Contributors