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.
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 — voirdocs/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: thesnitchformula name is already taken by an unrelated project; revisit once we have Developer ID signing / bloqué : le nomsnitchest 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-*.exeassets 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 maintainerCHOCO_API_KEYis set in repo secrets / paquet + installeur GPO silencieux prêts ; s'active dès qu'une cléCHOCO_API_KEYest posée dans les secrets - Headless Homebrew formula —
brew install aixisstudio/tap/snitchinstalls thesnitchddaemon binary (baresnitchCLI name de-conflicted vskarol-broda/snitch, #51) / formule Homebrew headless —brew install aixisstudio/tap/snitchinstalle le binairesnitchd(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
/procattribution today; Windows needsGetExtendedTcpTable, macOSlibproc/ attribution agent sur Windows/macOS — l'agent Rust livre déjà l'attribution/procLinux ; Windows exigeGetExtendedTcpTable, macOSlibproc - 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-*.ymlfeeds, opt-out in Settings / auto-mise à jour — electron-updater sur les fluxlatest-*.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 asUPLOAD_SPIKE/ livré viaUPLOAD_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.7More languages— 8 locales shipped infrontend/src/locales/; more welcome via a single-file PR / 8 locales livrées dansfrontend/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 attributesconnect()from short-lived processes thatpsutil.net_connectionsmisses (settingebpf_probe, needs python3-bcc + root; ambiguous destinations are never guessed). Full kernel-space packet capture stays here / livré, optionnel : kprobetcpconnectBCC pour attribuer lesconnect()des processus éphémères (réglageebpf_probe, exige python3-bcc + root). La capture noyau complète reste ici - WFP (Windows) — partially shipped:
detection/wfp.pydrivesfwpuclnt.dlldirectly via ctypes — per-app/IP/port ALE filters, delete-by-key, orphan purge. A kernel callout skeleton now lives incontrib/wfp-callout/(register/classify/unregister + signing README); a production signed driver with payload inspection stays here / partiellement livré :wfp.pypilotefwpuclnt.dllen ctypes — filtres ALE par appli/IP/port. Un squelette de callout noyau vit danscontrib/wfp-callout/; le pilote signé de production reste ici - NetworkExtension (macOS) — skeleton shipped:
contrib/macos-filter/holds aNEFilterDataProviderSwift skeleton + entitlements README — the only Apple-supported per-app outbound path (needs a paid Developer account). Verified:socketfilterfwonly polices incoming app connections — no user-mode substitute exists / squelette livré :contrib/macos-filter/contient un squeletteNEFilterDataProviderSwift — la seule voie sortante par-app d'Apple (compte Developer payant exigé). Vérifié :socketfilterfwne 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 eachconnect()— injected code in staging paths →INJECT_SUSPECT/ partiellement livré : scan RWX + mismatch nom/exe + hash + inspection Frida qui rapporte quel module a émis chaqueconnect()— 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 aussisend/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
.ggufloaded in-process viallama-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.gguffourni par l'utilisateur chargé en processus viallama-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/iocpackexports either a Bloom + randomized-response pack (ε≈4.6, deniable) or aformat=proofsalted-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.pywrapsperf_event_openin ctypes for cycles/instructions/cache-misses per pid (/security/perf, gated byperf_event_paranoid) — corroboratesMINING_SUSPECT/ livré, Linux : compteursperf_event_openen ctypes (/security/perf) — corroboreMINING_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_HITalerts with Host/SNI/process) and a zero-egress detonation sandbox (POST /security/sandbox— Linuxunshare -n, macOSsandbox-exec, pluscontrib/snitch-contain). Micro-VM containment stays here / livré : redirections + répondeur loopback :80/:443 + sandbox de détonation zéro-égress (unshare -nLinux,sandbox-execmacOS). 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):
throttlerule action polices a destination viatcclsact/flower at the rule's kbit rate / livré (Linux) : actionthrottlebride une destination viatcclsact/flower - PCAP export — shipped:
GET /forensics/pcapserves the bounded raw-frame ring (4 MiB) as a Wireshark-ready4 Mio) en.pcapwith real timestamps + optional ip/process filters / livré :GET /forensics/pcapsert l'anneau de trames brutes (.pcapWireshark 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.