Skip to content

Real-time network monitor + outbound firewall — see & block every connection. Privacy-first, local-first, Rust fleet agent, SIEM exports, 8 languages. / Moniteur réseau temps réel + pare-feu sortant, agent de flotte Rust, exports SIEM. 100 % local.

16.0 KB
Raw Blame

Roadmap / Feuille de route

English | Français | Español | Deutsch | Русский | 日本語 | Português | 中文

🇬🇧 Suggest or vote on features in GitHub Discussions — category Ideas. For concrete bugs, use Issues.

🇫🇷 Proposez ou votez pour des fonctionnalités dans les Discussions GitHub — catégorie Ideas. Pour les bugs concrets, utilisez les Issues.

✅ Shipped / Livré

Version What landed / Ce qui est arrivé
v1.0.4 First public release — real-time graph + world map, per-process attribution, offline geolocation (.mmdb), anomaly alerts, privacy score, LAN device discovery (passive ARP/OUI), mic/camera monitoring (Windows/Linux), demo mode, EN/FR UI / Première release publique — graphe temps réel + carte du monde, attribution par processus, géolocalisation hors-ligne, alertes d'anomalies, score de confidentialité, découverte LAN passive, monitoring micro/caméra, mode démo, UI EN/FR
v1.0.5 Windows support (Npcap, packaged backend), process icons, +24 tracker domains, PyInstaller console=False crash fix, interface auto-selection, dependency upgrades / Support Windows (Npcap, backend packagé), icônes de processus, +24 domaines trackers, correctifs

Also live / également en place : Docker image on GHCR, Homebrew tap (brew install --cask aixisstudio/tap/snitch), winget package submitted, zh-CN README, GitHub Discussions.

| v1.2 (main, untagged) | Security & threat-hunting suite — OS-firewall orchestration (rules IP/CIDR/domain/process/port via netsh/iptables/pf, best-effort privileges), lockdown panic switch, kill/suspend process actions, opt-in threat intel (AbuseIPDB/OTX), opt-in webhooks (Discord/Slack/Telegram/generic), DNS-tunnel & cleartext & country-baseline detection, security audit report, forensics export (process tree + SHA-256), 8-language UI (locales/ files) / suite sécurité & chasse aux menaces — orchestration pare-feu OS, bouton lockdown, actions kill/suspend, threat intel opt-in, webhooks opt-in, détection tunnel DNS / trafic clair / déviation pays, audit de sécurité, export forensique, UI en 8 langues | | v1.5.x | Enterprise / SOC layer — declarative snitch.toml ($SNITCH_CONFIG), CEF + RFC 3164 syslog + format=ecs NDJSON export, Sigma rule import + YARA-L export, /remote/fleet collector view + Helm chart (deploy/helm/snitch), Ansible / Puppet / Salt / GPO deploys (deploy/), hardened systemd unit + nfpm .deb/.rpm, free threat-intel feeds (StevenBlack, Blocklist.de, URLhaus/Feodo), MkDocs site + INTEGRATIONS.md in 7 languages / couche entreprise / SOC — snitch.toml déclaratif, syslog CEF/RFC 3164 + export ECS, import Sigma + export YARA-L, vue de flotte /remote/fleet + chart Helm, déploiements Ansible/Puppet/Salt/GPO, unité systemd durcie + .deb/.rpm nfpm, flux TI gratuits, site MkDocs + intégrations en 7 langues | | v1.6.x | Agent & fleet identity — zero-dependency Rust agent (agent/, Linux /proc socket→PID attribution, POST /ingest/events), per-agent enrollment (POST /ingest/enroll → one-shot sagt_… tokens, hashed at rest, /ingest/revoke), automatic TI-feed refresh worker (ti_feeds setting, per-feed interval, hot firewall reload), cross-platform agent CI (Linux/macOS/Windows), headless Homebrew formula snitchd (CLI name de-conflicted, #51), end-to-end green release pipeline (nfpm + tap + winget/choco-ready), all CodeQL alerts closed, 235-test backend suite / agent & identité de flotte — agent Rust zéro-dépendance (attribution socket→PID Linux via /proc), enrôlement par agent (jetons sagt_… hashés, révocation), worker de rafraîchissement TI automatique (ti_feeds), CI agent sur 3 OS, formule Homebrew headless snitchd, pipeline release vert de bout en bout, alertes CodeQL fermées, 235 tests backend |

🚧 v1.x — in progress / en cours

  • Signed Windows installer — CI wired for SignPath OSS (free Authenticode for approved projects); activates once the application is accepted — see docs/SIGNING.md / CI branchée sur SignPath OSS (signature Authenticode gratuite pour projets acceptés) ; s'active dès l'acceptation — voir docs/SIGNING.md
  • Signed & notarized macOS build — needs an Apple Developer account ($99/yr), no free path exists. Until then the tap strips quarantine for you / build macOS signée et notarisée — nécessite un compte Apple Developer, aucune voie gratuite. En attendant, le tap retire la quarantaine automatiquement
  • Homebrew upstream (brew install --cask snitch) — blocked: the snitch formula name is already taken by an unrelated project; revisit once we have Developer ID signing / bloqué : le nom snitch est déjà pris par un autre projet ; à revoir une fois la signature en place
  • winget publishing — PR #455520 (v1.0.8) open; release pipeline now auto-submits the latest NSIS build once Snitch-Setup-*.exe assets exist / PR v1.0.8 ouverte ; le pipeline soumet automatiquement le NSIS le plus récent dès que les assets existent
  • Chocolatey — package + silent GPO installer ready (installer/Snitch.nuspec); activates once a maintainer CHOCO_API_KEY is set in repo secrets / paquet + installeur GPO silencieux prêts ; s'active dès qu'une clé CHOCO_API_KEY est posée dans les secrets
  • Headless Homebrew formula — brew install aixisstudio/tap/snitch installs the snitchd daemon binary (bare snitch CLI name de-conflicted vs karol-broda/snitch, #51) / formule Homebrew headless — brew install aixisstudio/tap/snitch installe le binaire snitchd (nom CLI déconflictionné, #51)
  • Fleet scale-out — current ingest + SQLite WAL fits SME fleets; >1 000 agents needs a queue-backed collector (NATS/Kafka) and PostgreSQL/TimescaleDB storage / passage à l'échelle — l'ingest actuel + WAL convient aux PME ; au-delà de 1 000 agents, collecteur à file (NATS/Kafka) + stockage PostgreSQL/TimescaleDB
  • Agent attribution on Windows/macOS — the Rust agent ships Linux /proc attribution today; Windows needs GetExtendedTcpTable, macOS libproc / attribution agent sur Windows/macOS — l'agent Rust livre déjà l'attribution /proc Linux ; Windows exige GetExtendedTcpTable, macOS libproc
  • Windows 1-click installers — Electron NSIS (Snitch Setup.exe, native app + tray) and Inno Lite (Snitch-Lite-Setup.exe, backend + browser UI) build in CI on tags; shipping since v1.0.6 / installeurs Windows en un clic — NSIS Electron + Inno Lite, construits en CI aux tags ; livré depuis v1.0.6
  • Linux packages — .deb / AppImage / snap alongside Docker (no Flatpak: the sandbox cannot expose packet capture) / paquets Linux en plus de Docker — deb / AppImage / snap (pas de Flatpak : la sandbox ne peut pas exposer la capture)
  • Auto-update — electron-updater on the published latest-*.yml feeds, opt-out in Settings / auto-mise à jour — electron-updater sur les flux latest-*.yml, désactivable dans Réglages
  • Export formats — graph + alerts to JSON/CSV in the UI / export graphe + alertes en JSON/CSV dans l'UI
  • Deeper tracker coverage — community-editable lists live in backend/classifier/lists/ / couverture trackers élargie — listes éditables par la communauté
  • PCAP export — capture slices per host/session / export PCAP par hôte ou session

💭 Under consideration / à l'étude

  • Per-process bandwidth alert — shipped as UPLOAD_SPIKE / livré via UPLOAD_SPIKE
  • Custom alert rules in the UI / règles d'alerte personnalisées dans l'UI
  • Light theme / thème clair — shipped in v1.0.7 / livré en v1.0.7
  • More languages — 8 locales shipped in frontend/src/locales/; more welcome via a single-file PR / 8 locales livrées dans frontend/src/locales/ ; d'autres bienvenues via une PR d'un seul fichier
  • Optional remote pairing for headless hosts — consent-gated, token-protected / appairage optionnel d'hôtes sans écran — avec consentement et jeton
  • Map layers: ASN / organisation view / couches de carte : vue ASN / organisation
  • Blocklist imports (StevenBlack hosts, EasyList) — needs a privacy/licensing review first / import de blocklists — revue vie privée/licence requise
  • Firewall profiles (strict/travel vs developer/permissive) / profils pare-feu (strict/voyage vs dev/permissif)

🔬 Research — shipped vs remaining / livré vs restant

Ideas that would take Snitch toward a desktop EDR/XDR. v1.3/v1.4 shipped the user-mode-accessible parts of nearly all of them — what remains here genuinely needs a signed kernel component, an Apple entitlement or a research-grade build / Idées qui mèneraient Snitch vers un EDR/XDR de bureau. Les v1.3/v1.4 ont livré les parties accessibles en user-mode de quasiment toutes — ce qui reste ici exige réellement un composant noyau signé, un entitlement Apple ou un développement de recherche :

  • eBPF probes (Linux) — shipped, optional: a BCC tcpconnect-style kprobe attributes connect() from short-lived processes that psutil.net_connections misses (setting ebpf_probe, needs python3-bcc + root; ambiguous destinations are never guessed). Full kernel-space packet capture stays here / livré, optionnel : kprobe tcpconnect BCC pour attribuer les connect() des processus éphémères (réglage ebpf_probe, exige python3-bcc + root). La capture noyau complète reste ici
  • WFP (Windows) — partially shipped: detection/wfp.py drives fwpuclnt.dll directly via ctypes — per-app/IP/port ALE filters, delete-by-key, orphan purge. A kernel callout skeleton now lives in contrib/wfp-callout/ (register/classify/unregister + signing README); a production signed driver with payload inspection stays here / partiellement livré : wfp.py pilote fwpuclnt.dll en ctypes — filtres ALE par appli/IP/port. Un squelette de callout noyau vit dans contrib/wfp-callout/ ; le pilote signé de production reste ici
  • NetworkExtension (macOS) — skeleton shipped: contrib/macos-filter/ holds a NEFilterDataProvider Swift skeleton + entitlements README — the only Apple-supported per-app outbound path (needs a paid Developer account). Verified: socketfilterfw only polices incoming app connections — no user-mode substitute exists / squelette livré : contrib/macos-filter/ contient un squelette NEFilterDataProvider Swift — la seule voie sortante par-app d'Apple (compte Developer payant exigé). Vérifié : socketfilterfw ne contrôle que l'entrant
  • Memory/flow correlation — partially shipped: RWX scan + name/exe mismatch + exe hash + Frida deep-inspect (/security/deep_inspect) which reports which loaded module issued each connect() — injected code in staging paths → INJECT_SUSPECT / partiellement livré : scan RWX + mismatch nom/exe + hash + inspection Frida qui rapporte quel module a émis chaque connect() — code injecté en chemin de staging → INJECT_SUSPECT
  • Dynamic Taint Analysis — byte-observation slice shipped: Frida hooks now also cover send/WSASend/sendto/sendmsg, returning bounded head bytes + SHA-256 per outbound flow alongside module attribution. Full byte-for-byte exfiltration proof (real taint tracking) stays research / tranche d'observation livrée : les hooks Frida couvrent aussi send/WSASend/sendto/sendmsg — tête bornée + SHA-256 par flux sortant + attribution de module. La preuve d'exfiltration octet par octet complète reste en recherche
  • Local SecOps SLM — shipped, opt-in, two backends: Ollama-compatible endpoint restricted to loopback, or a user-provided .gguf loaded in-process via llama-cpp-python (slm_mode=embedded — zero network at all). Deterministic bilingual templates remain the default; Snitch never downloads weights / livré, opt-in, deux backends : endpoint Ollama loopback uniquement, ou .gguf fourni par l'utilisateur chargé en processus via llama-cpp-python (zéro réseau). Les gabarits restent le défaut ; Snitch ne télécharge jamais de poids
  • ZKP fleet intel — honest substitutes shipped: /security/iocpack exports either a Bloom + randomized-response pack (ε≈4.6, deniable) or a format=proof salted-Merkle commitment (exact membership, tamper-evident) — never raw IOCs. A real interactive ZK protocol + fleet transport stays research / substituts honnêtes livrés : paquets Bloom bruité OU engagement Merkle salé (format=proof, appartenance exacte, inviolable) — jamais d'IOC en clair. Un vrai protocole ZK + transport de flotte reste en recherche
  • PMU/hardware counters — shipped, Linux: detection/perfprobe.py wraps perf_event_open in ctypes for cycles/instructions/cache-misses per pid (/security/perf, gated by perf_event_paranoid) — corroborates MINING_SUSPECT / livré, Linux : compteurs perf_event_open en ctypes (/security/perf) — corrobore MINING_SUSPECT
  • Merkle integrity of loaded modules — shipped: a real Merkle root over file-backed executable mappings per process → MODULE_CHANGED; staging paths (/tmp, memfd, AppData Temp) → MODULE_SUSPECT. Kernel-enforced module allowlisting stays here / livré : racine Merkle sur les mappings exécutables → MODULE_CHANGED ; chemins de staging → MODULE_SUSPECT. L'allowlist noyau de modules reste ici
  • Sinkholing / micro-containment — shipped: redirects + a loopback responder on :80/:443 (SINKHOLE_HIT alerts with Host/SNI/process) and a zero-egress detonation sandbox (POST /security/sandbox — Linux unshare -n, macOS sandbox-exec, plus contrib/snitch-contain). Micro-VM containment stays here / livré : redirections + répondeur loopback :80/:443 + sandbox de détonation zéro-égress (unshare -n Linux, sandbox-exec macOS). Le confinement micro-VM reste ici
  • Cryptomining detection — shipped: stratum signatures in bounded payload heads + known pool ports, corroborated by sustained process CPU → MINING_STRATUM/MINING_SUSPECT / livré : signatures stratum + ports de pools, corroborés par CPU soutenue → MINING_STRATUM/MINING_SUSPECT
  • Egress throttling — shipped (Linux): throttle rule action polices a destination via tc clsact/flower at the rule's kbit rate / livré (Linux) : action throttle bride une destination via tc clsact/flower
  • PCAP export — shipped: GET /forensics/pcap serves the bounded raw-frame ring (4 MiB) as a Wireshark-ready .pcap with real timestamps + optional ip/process filters / livré : GET /forensics/pcap sert l'anneau de trames brutes (4 Mio) en .pcap Wireshark avec timestamps réels + filtres ip/processus optionnels

🚫 Out of scope / hors périmètre

Deliberately, by design / volontairement, par conception :

  • Telemetry, analytics, accounts, cloud sync — never. / Télémétrie, analytics, comptes, synchro cloud — jamais.
  • Passive network-wide IDS — Snitch watches this machine, not the whole network. / IDS passif à l'échelle du réseau — Snitch observe cette machine, pas tout le réseau.
  • User-space packet filtering — blocking is delegated to the OS-native firewall (or future kernel components), never reimplemented. / Filtrage de paquets en user-space — le blocage est délégué au pare-feu natif de l'OS (ou à de futurs composants noyau), jamais réimplémenté.

🤝 Contributing / contribuer

Good entry points / bons points d'entrée : good first issue labels, tracker-list PRs (backend/classifier/lists/), translations (i18n ready), packaging (Linux .deb/.rpm). See CONTRIBUTING.md.