AetherClaude — Agente Autônomo de Triagem GitHub
ten9876/aetherclaude
Triagem autônoma de GitHub issues com enforcement multi-camada de segurança
Ver no GitHubServidor 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/aetherclaude1 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
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:
- Detects issue state from a SQLite action log
- Triages new issues (Claude Code with the AetherSDR CLAUDE.md in context)
- Posts analysis, requests missing info, or transitions to implementation
- Implements fixes in a clean git worktree, runs validation, creates a PR
- Reviews incoming community PRs for convention compliance
- Auto-closes zero-effort submissions
Security architecture
Every agent run is wrapped in multiple enforcement layers:
- pf firewall —
aetherclaudeUID 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
waitingstate 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_, andsk-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.