Skip to content

About

Official GitHub Action to install, configure, and cache AgentShield CLI across Linux, macOS, and Windows CI/CD runner workflows.

Topics

Resources

Code of conduct

Contributing

Security policy

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Setup AgentShield GitHub Action

GitHub Marketplace npm version License: MIT SOC 2 / DPDP Compliant

Enterprise-grade Zero-Leak Secret Defense & Sandbox GitHub Action for Autonomous AI Coding Agents (Claude Code, Cursor, Windsurf, Aider, OpenHands).


🚀 Quickstart

Add RitualDev-Lab/setup-agentshield to your GitHub Actions workflow:

name: AI Agent PR Security Gate

on:
  pull_request:
    branches: [main, master]
  push:
    branches: [main, master]

jobs:
  agent-shield-check:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Setup AgentShield Defense
        uses: RitualDev-Lab/setup-agentshield@v1
        with:
          version: 'latest'
          air-gapped: 'true'
          check-leaks: 'true'

⚙️ Inputs

Input Description Required Default
version Package version of @ritualdev-lab/agentshield to install No latest
air-gapped Force 100% offline isolation (AGENTSHIELD_AIR_GAPPED=1), blocking all external network requests No true
strict-level Enforcement mode (audit, redact, terminate) No redact
check-leaks Automatically execute agentshield ci --enforce and fail the build if unmasked secrets are committed No false

📤 Outputs

Output Description
agentshield-version The resolved semantic version of AgentShield installed on the CI runner.
scan-status Result of the automated workspace leak check (passed, failed, or skipped).

🛡️ Autonomous Agent Sandboxing Workflow

If your CI pipeline runs automated AI code generation agents (e.g., Aider, Claude Code, auto-fix bots):

jobs:
  run-ai-coder:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup AgentShield
        uses: RitualDev-Lab/setup-agentshield@v1

      - name: Execute Autonomous Agent Under Sandbox
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        run: |
          # AgentShield wraps the agent execution, intercepting any attempt
          # to dump /proc/self/environ, echo raw tokens, or exfiltrate .env
          agentshield wrap --strict -- npx aider --message "Refactor auth controller"

🏛️ Enterprise Trust & Compliance

AgentShield is architected for defense-in-depth and compliance:

  • Zero Cloud Exfiltration: Runs 100% locally with AGENTSHIELD_AIR_GAPPED=1.
  • Statutory Alignment: Pre-built controls for India DPDP Act 2023, EU GDPR Article 32, and SOC 2 Type II.
  • Interactive Playground: Test evasion vectors live in the browser at ritualdev.in/playground.
  • Vendor Assessment Packet: View SIG Lite controls and architecture whitepaper at ritualdev.in/trust.

📄 License

MIT © RitualDev Studio



💖 Sponsor & Support

If you find this project valuable, consider supporting our open-source development:

Sponsor on Dodo Payments Interactive Donation Portal GitHub Sponsors


🛡️ Community & Governance

About

Official GitHub Action to install, configure, and cache AgentShield CLI across Linux, macOS, and Windows CI/CD runner workflows.

Topics

Resources

Code of conduct

Contributing

Security policy

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors