Ecc Agentshield

AgentShield — Security Scanner cho Agent Config

Audit Claude Code configuration cho vulnerabilities, misconfigurations, và injection risks.

Khi nào dùng

• Setup project mới với Claude Code
• Sau khi sửa .claude/settings.json, CLAUDE.md, hoặc MCP configs
• Trước khi commit config changes
• Security hygiene định kỳ

Cài đặt

npm install -g ecc-agentshield
# hoặc dùng npx không cần install
npx ecc-agentshield --version

Scan cơ bản

# Scan project hiện tại
npx ecc-agentshield scan

# Scan path cụ thể
npx ecc-agentshield scan --path /path/to/.claude

# Chỉ hiện từ severity nhất định
npx ecc-agentshield scan --min-severity medium

Output formats

npx ecc-agentshield scan                    # Terminal (màu + grade A-F)
npx ecc-agentshield scan --format json      # CI/CD integration
npx ecc-agentshield scan --format markdown  # Documentation
npx ecc-agentshield scan --format html > report.html

Auto-fix

npx ecc-agentshield scan --fix
# Tự động sửa những gì có thể: replace hardcoded secrets với env vars,
# tighten wildcard permissions, v.v.

Deep analysis (Opus 4.6)

export ANTHROPIC_API_KEY=your-key
npx ecc-agentshield scan --opus --stream
# Chạy 3 agents: Attacker (Red) → Defender (Blue) → Auditor (Final)

Những gì được scan

Grade scale

GitHub Action

- uses: affaan-m/agentshield@v1
  with:
    path: '.'
    min-severity: 'medium'
    fail-on-findings: true

Lỗi nghiêm trọng (fix ngay)

• Hardcoded API keys trong config files
• Bash(*) trong allow list (unrestricted shell)
• Command injection trong hooks qua ${file} interpolation
• Shell-running MCP servers

Source

https://github.com/affaan-m/agentshield · npm: ecc-agentshield