Versioned Cloud Drive

A shared drive for agents, apps, and teams.

LoonFS is a fully-featured cloud drive built on object storage. Give Claude Code, AI apps, and sandbox environments a real shared filesystem—with history, predictable sync, and links you can safely share.

AGENT-1: COMMAND SESSION
loonfs init /vfs/workspace/
AGENT-2: COMMAND SESSION
loonfs connect --shared
SHARED REMOTE: /vfs/agent-workspace/
Versioned Namespaces
Object Storage Native
Exact Revision Restore
Shareable Links
Shared Hot Caches
Built for Sandboxes
Human + Agent Workflows
API & CLI First
Configurable Indexing & Embeddings
Branches / Forks / Session Drives
Service-Account & Agent-Native Access
Versioned Namespaces
Object Storage Native
Exact Revision Restore
Shareable Links
Shared Hot Caches
Built for Sandboxes
Human + Agent Workflows
API & CLI First
Configurable Indexing & Embeddings
Branches / Forks / Session Drives
Service-Account & Agent-Native Access
/ Core Capabilities
Integration Showcase

A drive that fits how agents actually work.

Use LoonFS from a CLI, an internal tool, or a sandbox platform. Give agents a shared workspace with history, and give your product a durable filesystem abstraction instead of a temp directory.

main.py
index.ts
loonfs.sh
import loonfs

# Open a versioned namespace for an agent workflow
ns = loonfs.open_namespace("customer-support")

# Read shared context, then write new output
brief = ns.read_text("/briefs/today.md")
ns.write_text("/handoff/reply.md", draft_reply(brief))

# Publish a new revision and keep history intact
rev = ns.commit(message="claude: drafted reply")

# Create a short-lived link for a human reviewer
link = ns.share(
    "/handoff/reply.md",
    expires_in="24h"
)

# Sync only the remote changes you have not seen yet
changes = ns.changes(after_seq=last_seen_seq)
/ Features
[FIG. 01] / History

Versioned by default

Every change lands in an ordered namespace history. Restore old revisions without overwriting the present, and give agents a drive with real memory.

[FIG. 02] / Interfaces

CLI first. Agent friendly.

Start with a great CLI. Layer in APIs, SDKs, and agent tooling as you need them. LoonFS is designed for people, scripts, and sandboxes at the same time.

[FIG. 03] / Sharing

Share links without losing control

Publish files and folders to teammates or outside reviewers with identity-based access and short-lived links. Exact-revision sharing fits review and handoff workflows.

[FIG. 04] / Platform

Built for platforms, not just desktops

If you run sandboxes, background agents, or internal AI systems, LoonFS gives you a durable shared drive on top of object storage with shared hot caches for repeated workloads.

/ Architecture [ FIG. 02 ]
Infrastructure

Object storage native. Versioned like source control.

LoonFS stores durable data in object storage and exposes a shared drive on top: namespaces, revisions, sync, and shareable links. It is built for AI-native teams and platform builders that need agent-friendly filesystems, not just another mounted folder.

Namespace: agent-workspace Revision-aware
Type Versioned namespace
Backend S3 / R2 / compatible object storage
Consistency Ordered commits per namespace
History Immutable revisions
Sharing Links + identity access
/ Latest Stable Versions [ FIG. 03 ]

Hot-cache warming improvements and bug fixes for concurrent namespace access under high read throughput.

Changes
  • Optimized hot-cache tier for frequently accessed files
  • Fixed race condition in concurrent namespace locking
  • Reduced sync handshake latency by 18%
Update Command
pip install loonfs@latest // v0.3.1

Shareable links, revision history, and the new sync engine for real-time multi-agent collaboration on shared namespaces.

Major Features
  • Introduced shareable links with identity-scoped access
  • Full revision history with point-in-time restore
  • Real-time sync engine for concurrent agent + human writes
Migration: New Sync API
// Previous API (v0.2.x) from loonfs import Volume // v0.3.0 API from loonfs import Namespace, SyncEngine ns = Namespace.connect("agent-workspace") ns.sync(mode="realtime")

Object storage backend, namespace isolation, and the CLI for local development and sandbox environments.

Changes
  • S3-compatible object storage as the persistence layer
  • Namespace isolation for multi-tenant agent sessions
  • CLI tooling: loon init, loon sync, loon status
/ Quickstart [ FIG. 04 ]
Step 02 — Runtime Config

Initialize the namespace.

Before mounting volumes, initialize the LoonFS kernel. Use the CLI to generate your local manifest and set up sync credentials.

Terminal / Bash
$ npx @loonfs/cli init --name "agent-workspace-01"
loonfs.config.json
{ "namespace": "agent-workspace-01", "storage": "s3://loonfs-volumes", "sync": { "mode": "realtime", "conflict_resolution": "last-write-wins" } }
/ Deployment
Deployment Options

Start local. Grow into shared infrastructure.

Open source for self-hosting and early product work. Managed cloud and BYOC are the natural next steps for teams that want share links, org controls, and faster repeated reads.

Open Source
$0/mo

For self-hosting, internal prototypes, and product teams that want to build on LoonFS directly.

  • CLI-first workflow
  • Object-storage-backed namespaces
  • Revision history and restore
Cloud (Coming)
Waitlist

Hosted namespaces, share links, and a simpler control plane for AI-native internal teams.

  • Managed namespaces and links
  • High-performance hot caches
  • Org and identity controls
  • Operational visibility and support
Enterprise / BYOC
Custom

Customer-owned object storage, private networking, and a deployment model built for regulated environments.

  • Bring your own cloud
  • Private networking
  • Customer-managed storage policy
  • Deployment and design support