Rootless

Automate iOS, iPadOS, and macOS using plain JavaScript. Build custom widgets and interact directly with native APIs.

Plain JavaScript

Supports ES6. Scripts are stored as plain .js files on your disk.

Native APIs & Documentation

Integrate directly with iOS native APIs. Fully documented, available offline.

Siri Shortcuts

Trigger scripts via Siri. Present tables, websites, and custom HTML natively.

System Integration

Run from the Share Sheet, process inputs, and manage local files via Files.app.

x-callback-url

Communicate seamlessly and trigger workflows with other apps on your device.

Customizable & Ready

Tailor the code editor to your liking. Includes several example scripts to start immediately.

Documentation

Also inside the app, or as rootless.json.

FileSystem

File and directory access

The app's local storage and iCloud. Navigate directories, read and write files, and keep bookmarks to folders outside the app. Handles text, JSON, images and binary data.

Properties

localDirectory ›

The app's local storage directory.

iCloudDirectory ›

The app's iCloud container directory. May be null if iCloud is unavailable.

Methods

FileSystem.bookmarks(name)Any

Resolve a saved security-scoped bookmark by name. Returns a Directory or File.

name String required

FileSystem.saveBookmark(name, path)

Save a security-scoped bookmark.

name String required
path String required

Examples

Read & write files

const dir = FileSystem.local.documents;
const file = dir.file("data.json");

file.write(JSON.stringify({count: 1}));
const data = file.read("json");
console.log(data.count); // 1

File properties

// file.path, file.name, file.extension
// file.exists, file.size (bytes)
// file.createdAt, file.modifiedAt (DateTime)