unidrive

Multi-platform cloud-sync core. Pure JVM, zero telemetry. Modular SPI for Internxt Drive (zero-knowledge E2EE) and Microsoft OneDrive (Graph API). Runs as a user-space Linux daemon via systemd; platform tiers consume the engine over IPC — unidrive-mount-linux (FUSE) and unidrive-windows (CfAPI, read-only tier in MVP).

Technical Layout

.
├── core/
│   ├── app/
│   │   ├── cli/            # CLI entry point and subcommand mapping
│   │   ├── core/           # Engine, crypto, model sets
│   │   ├── hydration/      # De/hydration pipeline
│   │   └── sync-tracking/  # State reconciler and tracking-set engines
│   └── providers/
│       ├── internxt/       # Zero-knowledge encrypted client
│       └── onedrive/       # Microsoft Graph API client
└── dist/                   # User-space install scripts and systemd units

Build

JDK 21+, Linux with systemd --user.

./gradlew :core:app:cli:assemble    # build fat JAR

Install (user-space, no root)

cd dist/
./install.sh

Installs to:

• ~/.local/bin/unidrive
• ~/.local/lib/unidrive/unidrive-<version>.jar
• ~/.config/systemd/user/unidrive.service

Start daemon:

systemctl --user daemon-reload
systemctl --user enable --now unidrive.service

Daemon log: ~/.local/share/unidrive/unidrive.log. Quick triage: scripts/dev/log-watch.sh --summary.

Commands

unidrive uses a git-inspired subcommand design.

Session & Identity

• auth — OAuth/token provisioning
• profile — multi-profile management
• logout — destroy session, invalidate credentials

Sync

• sync — run tracking-set delta engine
• status — show alignment, transfers, exceptions
• conflicts — convergence paths for conflicting hashes

Storage

• pin / get — hydrate specific folders
• free — dehydrate to sparse markers
• vault — vault operations
• sweep — garbage-collect detached index fragments

Key source files

• ProviderFactory.kt — SPI provider registration framework
• TrackingEngine.kt — tracking-set delta calculator
• HydrationImpl.kt — physical payload de/reconstruction lifecycle