Skip to content
CAI
Software that uses CAICheck a score

bepass-org/oblivion

51.2

Adequate · 17 November 2026

18.1k

lines of production code

Dart

with Rust, Kotlin

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Oblivion is a cross-platform VPN client that unifies Android, iOS, Linux, macOS, and Windows through a shared Flutter interface and a native core engine. It provides advanced censorship resistance by integrating and chaining multiple transport protocols, including Aether, Psiphon, and Tor, with support for obfuscation and split tunneling. The system manages complex network configurations, such as MTU optimization and zero-trust authentication, while exposing detailed connection states and logs to the user.

Features

Add Linux desktop platform support

The Linux desktop build is now available, introducing a native GTK window runner for the Oblivion application. This change adds the necessary CMake build configuration, registers Flutter plugins (including screen retrieval, tray management, URL launching, and window management), and bundles the core tunnel binaries (Oblivion Core, Aether, and Psiphon) alongside a PolicyKit policy file to handle administrator privileges for tunneling.

linux · high confidence

Added Linux bundle packaging and root-execution tools

Introduced a new build tooling set for Linux distributions. The \bundle-linux-libs.sh\ script now automatically resolves and copies missing shared libraries into the application bundle and adjusts their RPATHs to ensure the app runs on desktops that lack specific dependencies (such as the ayatana/dbusmenu stack). Additionally, \run-linux-root.sh\ provides a safe mechanism to launch the bundled application with elevated privileges, handling necessary environment forwarding for both X11 and Wayland sessions.

tools · high confidence

Added national flag assets for supported countries

The application now includes SVG flag icons for multiple countries (including Austria, Australia, Azerbaijan, Belgium, Canada, Switzerland, Czechia, Germany, Denmark, Estonia, Spain, Finland, France, Great Britain, and Croatia) in the assets/flags directory. These assets support the new capability to offer Psiphon exit nodes from every available country, allowing users to visually identify their selected region.

assets · high confidence

Initial localization support for English and Persian

The app now supports English and Persian (Farsi) through a new localization system. This change introduces the app name 'Oblivion' and includes full translations for the user interface, covering connection states, settings (such as protocol selection, obfuscation, and split tunneling), and organizational Zero Trust account configuration. The localization files also include an introductory screen with memorial text honoring activists.

lib/l10n · high confidence

Initial project scaffolding and repository configuration

This change establishes the foundational structure for the application, introducing a Flutter-based codebase with support for Android, iOS, Linux, macOS, and Windows. It configures the project with standard linting rules, localization settings, and a MIT license. The repository is set up to manage external dependencies via Git submodules for the 'aether' core and 'hev-socks5-tunnel', while .gitignore rules are defined to exclude build artifacts, private identity files, and signing keys.

(repo-wide) · high confidence

New Oblivion core engine with tunnel mode and multi-core support

The native core has been rewritten to introduce a new connection engine that supports multiple transport cores (Aether, Psiphon, Tor) and chaining them together. It adds full tunnel mode support on Unix and Windows, including a dedicated helper process on Windows to manage the network device, DNS override capabilities on Unix, and system proxy configuration across Linux (GNOME/KDE), Windows, and macOS. The core also exposes a C-compatible API for the host application to manage connections, status, and logs.

_native/oblivion\core · high confidence

New service layer for tunnel management and core integration

This change introduces a new set of services in lib/data/services that handle the application's connection to the Aether core. It includes a desktop backend (DesktopTunnelBackend) that communicates with the core via native bindings, a unified TunnelChannel that abstracts platform-specific connections (native channels on mobile, FFI on desktop), and supporting services for managing Psiphon server lists, MTU probing, and application icon caching. The settings store has also been updated to support new tunnel configuration keys such as split tunneling, MTU, and various transport modes.

lib/data/services · high confidence

Behavioural changes

Added Android NDK build configuration for 16KB page alignment

The Android native build system now includes configuration files (Application.mk and Android.mk) to compile the hev-socks5-tunnel submodule. Specifically, the build is configured to support flexible page sizes with a 16KB alignment (max-page-size=16384), targeting Android API level 24 and multiple architectures (armeabi-v7a, arm64-v8a, x86\_64) in release mode.

android/aether-vpn/src/main/jni · high confidence

Android VPN service rewritten to use the Aether core with Psiphon and Tor support

The Android VPN implementation has been replaced with a new Kotlin-based service (AetherVpnService) that integrates the Aether core engine. This change introduces support for chaining Psiphon and Tor as core protocols, allowing users to configure exit locations, specific CDN IPs/SNIs for Psiphon, and Tor relay settings. The service now manages tunnel stages (connecting, validating, connected) and exposes detailed traffic statistics via a TProxy interface, replacing the previous architecture.

aether-vpn · high confidence

App restructured with new data models and Flutter UI foundation

The application has been rewritten in Flutter, introducing a new entry point (lib/app.dart) that manages the UI theme, localization, and desktop tray integration. This change brings a comprehensive set of new data models in lib/data/models to support advanced tunneling configurations: geo-endpoint details with Warp status, MTU profiles for various protocols (Masque, WireGuard, Gool), and detailed tunnel settings including carrier modes (chain, reverse, only) for Psiphon and Tor, TLS fingerprints, and conduit peer selection. Additionally, new status and capability models define the tunnel lifecycle stages and statistics, providing the foundation for the updated connection behavior.

lib/data/models · high confidence

Initial Flutter core implementation with desktop shell and theming

The application core has been rewritten in Flutter, introducing a new desktop shell that manages window sizing, centering, and system tray integration with dynamic icons based on connection status. A comprehensive theming system is now available, featuring light and dark palettes using the Vazirmatn font family, alongside utility formatters for displaying byte sizes and time durations.

lib/core · high confidence

Introduces Flutter-based app state management and version display providers

The application now uses a new set of Riverpod providers in the presentation layer to manage app preferences, tunnel settings, and geo-location state. This change introduces separate version providers for the core engine and Psiphon, allowing users to see these versions displayed independently. Additionally, the new provider structure supports a faster initial connection strategy and ensures the connect flow does not block on notification prompts, improving the responsiveness of the connection process.

lib/presentation/providers · medium confidence

MacOS app rewritten in Flutter

The MacOS application has been rewritten using Flutter, replacing the previous native implementation. This change introduces a new Xcode project structure that integrates Flutter for the UI layer while connecting to the 'aether core' for backend logic. Users will now experience the MacOS app built on the Flutter framework, which includes support for plugins such as tray management, window management, and URL launching, ensuring consistent behavior with other Flutter-based platforms.

macos · high confidence

Migration to Aether core with Psiphon and Tor support

The Android VPN service has been rewritten to use the new Aether core, replacing the previous implementation. This change introduces support for chaining Psiphon and Tor as transport carriers, allowing users to route traffic through these networks for enhanced censorship resistance. The update includes a new process management layer (AetherCore) to handle the core binary lifecycle, a configuration model (TunnelConfig) to manage carrier-specific settings like country selection and obfuscation profiles, and a status bus (TunnelBus) for real-time connection state and logging. Additionally, a SocksProbe utility has been added to verify connectivity through the SOCKS proxy provided by the core.

android/aether-vpn/src/main/kotlin · high confidence

Rewritten Flutter UI with Aether core integration and new settings screens

The presentation layer has been rewritten in Flutter, replacing the previous implementation to integrate with the Aether core engine. This change introduces a new set of screens including Home, Settings, Advanced, Psiphon, Split Tunnel, Zero Trust, Logs, and About. The UI now displays separate version information for the Aether core and Psiphon, allows configuration of core engines (Aether, Psiphon, Tor, Chain) and protocols (Masque, WireGuard, Gool, MIM), and provides controls for split tunneling, MTU optimization, and zero-trust authentication. The home screen shows the current connection state and mode, while the logs screen loads retained logs on open and supports copying.

lib/presentation/screens · high confidence

Windows app now uses a Flutter-based UI with bundled native core libraries

The Windows application has been rewritten using Flutter, replacing the previous implementation. This change introduces a new build system (CMake) and runner architecture that integrates the 'oblivion' core, the 'aether' core, and the 'psiphon' core as bundled native libraries. The UI now runs on the Flutter engine and registers standard plugins for screen retrieval, tray management, URL launching, and window management, ensuring the application bundles all necessary native assets and helper binaries for a self-contained installation.

windows · high confidence

iOS app rewritten in Flutter with Aether core integration

The iOS client has been rewritten in Flutter, replacing the previous native implementation. This change introduces the Aether core as the underlying tunnel engine, managed via a new PacketTunnelProvider and an OblivionPlugin for Flutter-to-native communication. The tunnel now supports configurable protocols (including 'gool' and 'masque'), automatic obfuscation, and specific MTU settings (defaulting to 1500 bytes), providing users with the same connectivity features but through a new, unified codebase.

android, ios · high confidence

Test coverage

Added tests for tunnel chaining, connection details, and core protocol settings

Added comprehensive test coverage for the tunnel configuration and UI components. Tests verify that chaining Tor and Psiphon with Aether correctly manages port allocation and upstream routing, and that the home screen's connection detail and mode badge widgets render correctly for various carrier combinations and exit types. Additional tests cover core protocol options, including Masque SNI handling, Encrypted Client Hello (ECH) configuration, gateway scanning logic, and MTU plan resolution for different network paths and IP versions.

test · high confidence

Dependencies

Android build configuration and dependency updates

The Android build system has been updated to compile against SDK 37 and Java/Kotlin 17, with the Android Gradle Plugin upgraded to version 9.0.1 and Kotlin to 2.3.20. The native core dependencies (Cargo.lock) now pin specific versions for libraries such as serde, libc, and windows-sys, while the Flutter app dependencies (pubspec.lock) have been refreshed to include versions like flutter\_riverpod 2.6.1 and flutter\_svg 2.3.0.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 52.9 → 51.2 (-1.7)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 73.8 → 73.3 (-0.5)
  • Architecture 91.7 → 82.0 (-9.7)
  • Maturity 55.2 → 55.3 (+0.1)
  • Readiness 41.8 → 38.7 (-3.1)
  • Security 77.3 → 77.3 (0.0)
  • Performance 60.0 → 60.0 (0.0)

Resolved (5)

  • Hotspot: android/app/src/main/kotlin/org/bepass/oblivion/OblivionPlugin.kt (android/app/src/main/kotlin/org/bepass/oblivion/OblivionPlugin.kt)
  • Hotspot: ios/OblivionTunnel/PacketTunnelProvider.swift (ios/OblivionTunnel/PacketTunnelProvider.swift)
  • Hotspot: lib/presentation/screens/psiphon_screen.dart (lib/presentation/screens/psiphon_screen.dart)
  • No ADRs found
  • Off-boarding risk: anonymized user #1

New (13)

  • Duplicated block (8 lines × 2) (android/aether-vpn/src/main/kotlin/org/bepass/oblivion/vpn/AetherCore.kt)
  • Edited copies of one member (3 members, 5+ corresponding lines) (lib/presentation/screens/advanced_screen.dart)
  • Edited copy of a member (10 corresponding lines) (native/oblivion_core/src/net.rs)
  • Edited copy of a member (11 corresponding lines) (native/oblivion_core/src/supervisor.rs)
  • Edited copy of a member (13 corresponding lines) (native/oblivion_core/src/psiphon.rs)
  • Edited copy of a member (14 corresponding lines) (android/aether-vpn/src/main/kotlin/org/bepass/oblivion/vpn/AetherVpnService.kt)
  • Edited copy of a member (14 corresponding lines) (lib/data/services/desktop_tunnel_backend.dart)
  • Edited copy of a member (2 corresponding lines) (lib/data/models/tunnel_settings.dart)
  • Edited copy of a member (21 corresponding lines) (lib/data/services/tunnel_channel.dart)
  • Edited copy of a member (27 corresponding lines) (lib/presentation/screens/home_screen.dart)
  • Edited copy of a member (7 corresponding lines) (native/oblivion_core/src/net_windows.rs)
  • No ADRs found (native/oblivion_core/Cargo.toml)
  • Off-boarding risk: anonymized user #1

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

bepass-org/oblivion was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit bd8d2ac0659ac7524504354f8756447e6a54ef92 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.