Quickstart
Create an agent workspace, write a persistent file, and try agent-specific undo.
Before you begin
You need Agent Filesystem access, Linux x86-64 with FUSE, and a writable /workspace directory. Run setup in a trusted environment and keep the user profile outside the agent’s working directory.
Create your app
- Open Developer Console Credentials, click Create credential, and select Agent Filesystem.
- Enter a unique application name, click Create application, and copy the App key and App secret.
Complete email verification or developer onboarding if prompted.
Creating this credential creates a Dropbox app for your integration. Managed users are separate API-only users you create later; they do not need another Dropbox signup.
Store credentials in your backend secret store; keep the app secret out of browser and agent code.
Install the CLI and connect a user
Choose one sign-in path. Both use the standalone-user profile below.
Existing Dropbox user
Managed user
Replace your-app-key and follow the CLI’s authorization instructions.
Mount your Dropbox
Mount the account you signed in as in Step 2. You’ll use it to create the agent’s folder and to check the agent’s work. A new managed user’s Dropbox starts empty.
Create an agent with a scoped workspace
An agent can use only the folders in its workspace, and each folder must already exist. --add takes a path in your Dropbox, not on this machine.
On a team account, put your member folder before AgentFSQuickstart in every path from here on, and quote paths with spaces: for example, mkdir '/workspace/dropbox/Jane Doe/AgentFSQuickstart' and --add '/Jane Doe/AgentFSQuickstart=read_write'. See workspace paths.
Write and verify a persistent file as the agent
Mount the agent’s workspace in a second local directory. Both mounts show the same Dropbox folder, but the agent sees only its workspace. dbx mount syncs files with Dropbox automatically.
After the file syncs, read it through the user mount:
Inspect and undo the agent's write (optional)
Stop the agent’s mount so no writes are in progress, then find its write in the mutation history:
Copy the TIMESTAMP_US for hello.txt and undo from there:
See Recovery for what undo can and can’t restore.
When you’re done, stop your mount. If you skipped Step 6, stop the agent’s mount first with dbx mount stop /workspace/agent.
For production token handling, see Authentication. For mount lifecycle and runtime isolation, see Mount.