James Pine 73ec35656b plans
2026-03-24 16:37:09 -07:00
2026-03-24 14:23:55 -07:00
fsl
2026-03-24 14:32:31 -07:00
2026-03-24 14:23:55 -07:00
fsl
2026-03-24 14:32:31 -07:00
2026-03-24 16:37:09 -07:00
2025-10-11 13:14:01 -07:00
fsl
2026-03-24 14:32:31 -07:00
2026-01-23 08:51:27 +03:00
2023-04-27 07:32:15 +00:00
2025-12-02 13:17:28 -05:00
2025-11-06 05:25:15 -08:00
2025-11-06 02:20:34 -08:00
2025-12-10 20:31:10 -08:00
fsl
2026-03-24 14:32:31 -07:00
2022-06-14 13:13:09 -07:00
2026-03-24 16:37:09 -07:00
fsl
2026-03-24 14:32:31 -07:00
2026-03-24 16:37:09 -07:00

Spacedrive

Spacedrive

An open source cross-platform file operating system.
Powered by a virtual distributed filesystem written in Rust.

spacedrive.comDiscordGetting Started


What is Spacedrive?

Spacedrive is a file manager that treats files as first-class objects with content identity, not paths. A photo on your laptop and the same photo on your NAS are recognized as one piece of content. Organize files across multiple devices, clouds, and platforms from a single interface.

  • Content identity — every file gets a BLAKE3 content hash. Same file on two devices produces the same hash. Spacedrive tracks redundancy and deduplication across all your machines.
  • Cross-device — see all your files across all your devices in one place. Files on disconnected devices stay in the index and appear as offline.
  • P2P sync — devices connect directly via Iroh/QUIC. No servers, no cloud, no single point of failure. Metadata syncs between devices. Files stay where they are.
  • Cloud volumes — index S3, Google Drive, Dropbox, OneDrive, Azure, and GCS as first-class volumes alongside local storage.
  • Nine views — grid, list, columns, media, size, recents, search, knowledge, and splat. QuickPreview for video, audio, code, documents, 3D, and images.
  • Local-first — everything runs on your machine. No data leaves your device unless you choose to sync between your own devices.

Is this a replacement for Finder or Explorer?

Not exactly.

Spacedrive is not trying to replace Finder on macOS or Explorer on Windows as the default system file manager. That is not the goal, and it is not where the product is strongest.

Spacedrive sits on top of your operating system and adds capabilities the stock file manager does not have:

  • Portal across everything — one place to search and browse files across local disks, external drives, NAS, cloud storage, and archived data sources.
  • Operating surface for files — content identity, sidecars, derivative artifacts, rich metadata, sync, and cross-device awareness built into the core model.
  • Embeddable and shareable — run it as a desktop app, a headless server, a hosted file service, or embed the interface and APIs into other products.
  • AI-ready by design — prepare data ahead of time through indexing and analysis pipelines instead of giving agents raw shell access to your filesystem.
  • Safer access model — route AI and automation through Spacedrive's structured APIs, permissions, and processing layers instead of direct file reads and shell commands.

You still use your operating system for low-level file interactions. Spacedrive adds the cross-platform, cross-device, cloud-aware, shareable, and automation-friendly layer on top.

If Finder or Explorer is the street-level view of your files, Spacedrive is the map, index, archive, and control plane.

Data Archival

Beyond files, Spacedrive can index and archive data from external sources via script-based adapters. Gmail, Apple Notes, Chrome bookmarks, Obsidian, Slack, GitHub, calendar events, contacts. Each data source becomes a searchable repository. Search fans out across files and archived data together.

Adapters are simple: a folder with an adapter.toml manifest and a sync script in any language. If it can read stdin and print lines, it can be an adapter.

Shipped adapters: Gmail, Apple Notes, Chrome Bookmarks, Chrome History, Safari History, Obsidian, OpenCode, Slack, macOS Contacts, macOS Calendar, GitHub.

Spacebot

Spacedrive integrates with Spacebot, an open source AI agent runtime. Spacebot runs as a separate process alongside Spacedrive, communicating over APIs. Spacedrive provides the data layer. Spacebot provides the intelligence layer. Neither depends on the other. Together, they form an operating surface where humans and agents work side by side.

File System Intelligence

Spacedrive adds a layer of file system intelligence on top of the native filesystem. It does not just expose files and folders. It understands what they are, why they exist, how they are organized, and what agents are allowed to do with them.

File System Intelligence combines three things:

  • File intelligence — derivative data for individual files such as OCR, transcripts, extracted metadata, thumbnails, previews, classifications, and sidecars.
  • Directory intelligence — contextual knowledge attached to folders and subtrees, like "this is where I keep active projects" or "this archive contains dormant repositories".
  • Access intelligence — universal permissions and policy that apply across devices and clouds, so agents can be granted structured access through Spacedrive instead of raw shell access.

This makes the filesystem legible to AI. When an agent navigates a path through Spacedrive, it does not walk blind. It receives the listing, the relevant context for that subtree, the effective permissions, and summaries of what lives there. A projects folder is not just a folder. It is an active workspace. An archive is not just another directory. It carries historical meaning and policy.

That context evolves over time. Users can explain how they organize their system. Agents can add notes and observations with attribution. Jobs can generate summaries from structure and activity. Spacedrive keeps that intelligence attached to the filesystem itself instead of burying it inside temporary session memory.

The result is a file system that feels native to both humans and agents. Finder and Explorer show you where files are. Spacedrive adds the intelligence layer that explains what they are, how they relate, and how automation should interact with them.


Architecture

The core is a single Rust crate with CQRS/DDD architecture. Every operation (file copy, tag create, search query) is a registered action or query with type-safe input/output that auto-generates TypeScript types for the frontend.

Component Technology
Language Rust
Async runtime Tokio
Database SQLite (SeaORM + sqlx)
P2P Iroh (QUIC, hole-punching, local discovery)
Content hashing BLAKE3
Vector search LanceDB + FastEmbed
Cloud storage OpenDAL
Cryptography Ed25519, X25519, ChaCha20-Poly1305, AES-GCM
Media FFmpeg, libheif, Pdfium, Whisper
Desktop Tauri 2
Mobile React Native + Expo
Frontend React 19, Vite, TanStack Query, Tailwind CSS
Type generation Specta
spacedrive/
├── core/                  # Rust engine (CQRS/DDD)
├── apps/
│   ├── tauri/             # Desktop app (macOS, Windows, Linux)
│   ├── mobile/            # React Native (iOS, Android)
│   ├── cli/               # CLI and daemon
│   ├── server/            # Headless server
│   └── web/               # Browser client
├── packages/
│   ├── interface/         # Shared React UI
│   ├── ts-client/         # Auto-generated TypeScript client
│   ├── ui/                # Component library
│   └── assets/            # Icons, images, SVGs
├── crates/                # Standalone Rust crates (ffmpeg, crypto, etc.)
├── adapters/              # Script-based data source adapters
└── schemas/               # TOML data type schemas

Getting Started

Requires Rust 1.81+, Bun 1.3+, just, and Python 3.9+ (for adapters).

git clone https://github.com/spacedriveapp/spacedrive
cd spacedrive

just setup        # bun install + native deps + cargo config
just dev-daemon   # start the daemon
just dev-desktop  # launch the desktop app (connects to daemon)
just dev-server   # headless server (alternative to desktop)
just test         # run all workspace tests
just cli -- help  # run the CLI

Contributing


License

FSL-1.1-ALv2 — Functional Source License, converting to Apache 2.0 after two years.

Description
No description provided
Readme 375 MiB
Languages
Rust 76.8%
TypeScript 19.7%
Python 1.2%
Swift 1%
Shell 0.4%
Other 0.7%