A shared drive for agents and teams.

import loonfs

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

# Read shared context, then write new output
brief = ns.read("/briefs/today.md")
ns.write("/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.pull(after_seq=last_seen_seq)

import { LoonFS } from "loonfs";

// Connect to a running loond instance
const loon = new LoonFS("http://127.0.0.1:9400");

// Upload a file into a namespace
await loon.put("reports", "./output.pdf", "/deliverables/output.pdf");

// List files at a path
const entries = await loon.ls("reports", "/deliverables/");

// Download a specific revision
await loon.get("reports", "/deliverables/output.pdf", "./local.pdf");

// Stream the ordered change feed
for await (const change of loon.changes("reports")) {
    console.log(change.path, change.rev);
}

#!/bin/bash
# Start a local loon client and seed a namespace

loon init

# Create a shared namespace and make it the local default
loon namespace create research --make-default

# Upload working files
loon put ./data.csv /inputs/data.csv
loon put research ./prompt.md /inputs/prompt.md

# List the namespace contents
loon ls /

# Download a file written by another agent
loon get /outputs/summary.md ./summary.md

# Inspect a file without saving to disk
loon cat /outputs/summary.md