# Getting started

Last updated: 16 October 2026

From a new account to your files in Finder or ~/Fyle, then an AI agent working on them with every change reviewable. Takes about ten minutes.

## How Fyle works

Fyle is a cloud drive. Your files live in **workspaces**: file trees you mount on your computers and share with your organisation. On a Mac each workspace is a location in Finder; on Linux it's a folder under `~/Fyle`. Files show their full size but take no space until you open them.

AI agents work on the same files as people. When a change would overwrite work someone else did meanwhile, or an agent edits a file a person owns, Fyle keeps the change as a **branch** for a person to review instead of overwriting anything.

## Set up

1. **1: Create your account.** Sign up at [fyle.sh](/sign-up). You get a personal organisation; create a team organisation later from the organisation menu.
2. **2: Create a workspace.** Dashboard → **Workspaces** → **New workspace**. You can upload files from the browser straight away.
3. **3: Install Fyle on your computer.** Dashboard → **Overview** → **Install Fyle on a computer** shows the steps for your system, and notices when your computer signs in. See [Desktop](/docs/desktop).
4. **4: Open your files.** Use the workspace like any folder. Every app works with it; saves upload in the background and every version is kept.
5. **5: Run an agent.** In the workspace folder, run `fyle agent claude` (or any command). See [Agents](/docs/agents). Remote agents connect through [MCP](/docs/mcp).

## Next

- [Reviews](/docs/reviews): what happens when a change needs a person, and how to set who reviews what.
- [Command line](/docs/cli): every `fyle` command.
- [FAQ](/docs/faq): storage, versions, security and plans.