File System

carbon add plugin FileSystem

Configure allowed roots:

{ "plugins": { "fs": { "scopes": ["$APPDATA/**", "$DOCUMENT/**"] } } }

import { fs } from '@dotcarbon/plugin-fs'

await fs.createDir('/approved/profiles')
await fs.writeFile('/approved/profiles/main.json', JSON.stringify(profile))
const contents = await fs.readFile('/approved/profiles/main.json')
const entries = await fs.readDir('/approved/profiles')
await fs.rename('/approved/old.json', '/approved/new.json')
await fs.delete('/approved/new.json')

The plugin normalizes paths and rejects operations outside configured scopes. Prefer app-owned data directories over broad document or external-storage access.