agent-blackbox

Claude Code, Codex CLI ve Gemini CLI her oturumu zaten diskinize yazıyor. agent-blackbox bu kayıtları okur ve adım adım bir zaman çizelgesi, okunabilir 26 kurala dayanan bir risk denetimi ve bir geri alma haritası çıkarır. Hiçbir yere bir şey göndermez.

Kurallar
26
Okunan ajanlar
Claude Code, Codex CLI, Gemini CLI
Ağ çağrısı
yok
Bağımlılık
yok
Lisans
MIT

Örnek çıktı

Aşağıdaki alıntı, bu sitenin hazırlandığı makinede --scan --days 7 ile yapılan gerçek bir çalıştırmadan kısaltıldı. Oturum klasörlerinin adları değiştirildi. Geri kalan her şey tarayıcının yazdığı gibi. Tarama hiçbir ağ çağrısı yapmadı.

# Risk report — last 7 days

Source note: 25 sessions scanned (all) · Risk score: 395 (high)

## Most triggered rules

| Rule                     | n  | Severity |
|--------------------------|----|----------|
| force-kill               | 21 | low      |
| fs-recursive-delete      | 20 | high     |
| hardcoded-credential     | 13 | medium   |
| write-outside-workspace  |  6 | medium   |
| git-hard-reset           |  2 | high     |
| secret-file-access       |  2 | high     |

## Findings (top of 36)

| Severity | Rule                | Session    | Evidence           |
|----------|---------------------|------------|--------------------|
| high     | fs-recursive-delete | `e7d88fce` | `rm -rf`           |
| high     | git-hard-reset      | `efb30291` | `git reset --hard` |
| high     | secret-file-access  | `2f51f1d8` | `.env`             |

Her bulgu, tetiklenen kuralı, tetiklendiği oturumu ve eşleşen metni gösterir. Böylece tek bir bulguya itiraz edebilirsiniz. Kurallar açıp okuyabileceğiniz tek bir dosyada duruyor. Katılmadığınız bir kuralı --ignore ile kapatabilirsiniz.

Kurulum

# bir kez
> /plugin marketplace add halilneed/plugins

# eklenti
> /plugin install agent-blackbox@hailneed

# ve deneyin
> /agent-blackbox:risk

Market kimliği hailneed, kurulum satırının @hailneed ile bitmesinin nedeni bu.

  • Claude Code ve Node.js 18 ya da daha yenisi.
  • Bağımlılık, derleme adımı, API anahtarı ya da hesap gerekmez.
  • Eklenti olmadan da çalışır: node scripts/blackbox.mjs --scan --days 30 --md
  • CI için --scan --out risk.json sabit bir çıktı biçimi verir. Böylece risk puanı belirlediğiniz eşiği geçtiğinde derleme başarısız olabilir.

Komutlar

/agent-blackbox:timeline

Oturumu adım adım gösterir: ne istendi, ne çalıştı, ne bozuldu ve ne değişti. Hata zincirlerini, reddedilen çağrıları ve zamanın nereye gittiğini de gösterir.

/agent-blackbox:risk

Ajanın çalıştırmasına izin verilen şeylerin denetimi: yıkıcı komutlar, bir döküme düşmüş gizli bilgiler, izin ve sandbox atlatmaları, çalışma alanı dışına yazmalar. Her yüksek bulgu raporlanmadan önce dökümle karşılaştırılarak doğrulanır. Doğrulanamayan bulgu çıkarılır.

/agent-blackbox:undo

Ajanın dokunduğu her dosyayı bir kurtarma kaynağıyla eşler (kendi yedeği, git ya da ters yama). Hiç geri alınamayacak olanları ayrı bir listede verir. Bir kurtarma önerir, kendi başına hiçbir şeyi geri yüklemez.

Ne yapar, ne yapmaz

  • Ağ çağrısı yapmaz. Tarayıcı yalnızca diskinizde zaten bulunan dosyaları okur. blackbox.mjs içinde fetch ya da soket yok.
  • Gizli bilgiler, herhangi bir rapor yazılmadan önce maskelenir: API anahtarları, JWT’ler, özel anahtar başlıkları ve kimlik bilgisi içeren bağlantı dizeleri. Maskeleme varsayılan olarak açıktır. --no-redact seçeneği var, kullanıp kullanmamak size kalmış.
  • Düşünme metni kayıttan hiç çıkmaz. Yalnızca sayısı raporlanır.
  • 26 kural var, model yargısı yok. rules.mjs okuyabileceğiniz bir desen listesi. --selftest bu listeyi verilerinize dokunmadan 33 test örneği üzerinde çalıştırır.
  • Okunamayan oturumlar kaynak notunda sayılır.
  • MIT lisanslı (LICENSE). Hesap, kayıt ya da telemetri yok.

Planlanan

Barındırılan bir sürüm, agent-blackbox Cloud, planlanıyor. Eklenti ücretsiz ve yerel kalacak.

  • Ekip toplamı: her üyenin raporları tek bir panoda.
  • Ekibin makinelerinde risk eğiliminin zaman içindeki seyri.
  • Politika uyarıları ve denetim dışa aktarımı: ihlalde Slack ya da Telegram bildirimi, ISO/SOC2 kanıtı için biçimlenmiş denetim izi dışa aktarımı.

Hazır olduğunda haber almak için yazılar sayfasından abone olun.