Quickstart

The fastest path is hosted: Agent Relay runs the integration stack for you — OAuth, sync workers, writeback — so you only run a local mount. One command and you have provider-backed files in an ordinary directory.

One command

If you want Notion, Slack, Linear, GitHub, or other provider-backed files without running infrastructure, use Hosted Agent Relay. The CLI logs you in, creates or joins a cloud workspace, completes provider auth, waits for sync, and mounts the result.

relayfile setup \
  --provider notion \
  --workspace my-agent \
  --local-dir ./relayfile-mount \
  --no-open

--no-open prints the hosted login and connect URLs instead of opening a browser — useful inside agents and headless environments. The command connects to agentrelay.com, completes the Nango connect flow, blocks until the provider reports ready, and starts the mount sync loop.

When it returns, ./relayfile-mount is a live mirror of your workspace:

ls ./relayfile-mount/notion
cat ./relayfile-mount/LAYOUT.md

See Relayfile Cloud for what the hosted plane manages, and Mounting to do the same thing programmatically from a sandbox.

Read and write

Once mounted, the interface is the filesystem you already know:

# read
cat ./relayfile-mount/linear/issues/AGE-12__fix-login-bug.json

# patch back to the provider by writing the canonical path
echo '{"state":"In Review"}' \
  > ./relayfile-mount/linear/issues/AGE-12__fix-login-bug.json

# find across providers
grep -rl '"state":"Todo"' ./relayfile-mount/linear/issues/

See Reads and writes for the full PATCH / CREATE / DELETE model.

Next steps