convez.ai
MCP ServerDevOps & InfraestruturaAvançado
ten9876

AetherClaude — Agente Autônomo de Triagem GitHub

ten9876/aetherclaude

Triagem autônoma de GitHub issues com enforcement multi-camada de segurança

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que implementa um agente autônomo de triagem de issues GitHub com arquitetura focada em segurança. Detecta duplicatas, implementa correções em worktrees limpas, revisa PRs comunitárias e compila notas de lançamento, tudo protegido por firewall pf, DefenseClaw CodeGuard e MCP Scanner.

Instalação

$npx convez-ai ten9876/aetherclaude

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
5
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Triagem automática e classificação de issues em repositórios de código aberto
  • Detecção de duplicatas e fechamento de submissões de baixo esforço
  • Implementação assistida de correções com validação de segurança antes de PR
  • Revisão de PRs comunitárias para conformidade de convenções

Veredito

Sistema robusto e production-ready para automação de governança em repositórios, com camadas de segurança bem pensadas (pf, CodeGuard, token scrubbing, eBPF). Ideal para times que precisam escalar triagem sem comprometer integridade — exige infraestrutura dedicada (Mac Mini) e conhecimento profundo de segurança.

README

A tradução para o português deste README ainda está na fila.

AetherClaude

Autonomous GitHub issue triage agent for AetherSDR — a security-first AI coding agent that triages issues, implements fixes, reviews community PRs, detects duplicates, explains CI failures, and compiles release notes.

What it does

Runs on a dedicated Mac Mini, triggered by GitHub webhooks in real time (with an hourly fallback timer). Each cycle:

  1. Detects issue state from a SQLite action log
  2. Triages new issues (Claude Code with the AetherSDR CLAUDE.md in context)
  3. Posts analysis, requests missing info, or transitions to implementation
  4. Implements fixes in a clean git worktree, runs validation, creates a PR
  5. Reviews incoming community PRs for convention compliance
  6. Auto-closes zero-effort submissions

Security architecture

Every agent run is wrapped in multiple enforcement layers:

  • pf firewall — aetherclaude UID can only reach GitHub, Anthropic, Cloudflare tunnel, and telemetry endpoints. Everything else dropped.
  • tinyproxy — HTTP proxy with domain allowlist
  • Cisco DefenseClaw CodeGuard — static analysis of every changed file before a PR is pushed (blocks HIGH/CRITICAL findings)
  • Cisco MCP Scanner — YARA + prompt-defense scan of MCP tool declarations
  • Cisco Skill Scanner — blocks injected .claude/ skills in the workspace
  • Validation gate — blocks modifications to .github/, Dockerfile, and other protected paths
  • DB-driven state machine — no "proceeding with best judgment" bypass; issues in waiting state stay there until user replies or 7 days elapse
  • Tetragon (eBPF observability) — records every tool invocation
  • Token scrubbing — session JSONL files are scanned on every run for ghs_, ghp_, github_pat_, and sk-ant- leaks

Repository layout

bin/             Scripts executed by the agent
skills/          Claude Code prompt templates (triage, implement, review, …)
config/
  launchd/       macOS service definitions
  pf/            firewall anchor
  cloudflared/   tunnel config (no credentials)
scripts/
  deploy.sh      pull + restart on the Mac Mini

Copy .env.example to ~/.env and fill in the two values to bootstrap.

Deploying

On the Mac Mini:

git clone https://github.com/ten9876/aetherclaude.git ~/src/aetherclaude
cd ~/src/aetherclaude
./scripts/deploy.sh

The deploy script symlinks bin/ scripts into /Users/aetherclaude/bin/, copies configs into their system locations, and restarts affected launchd services.

Subsequent edits: commit to main, then on the Mac Mini run ~/src/aetherclaude/scripts/deploy.sh.

License

GNU Affero General Public License v3.0 — see LICENSE.

AGPL-3.0's network copyleft clause matters here: AetherClaude is a hosted agent that interacts with users over GitHub. Anyone running a modified version of this code as a hosted service must make their modifications available to the users they're serving.


Part of the AetherSDR project. Maintained by Jeremy KK7GWY with AI assistance.

Ver o original no GitHub

Bom para

Relacionados