Quickstart

Sync your first folder in under five minutes. The CLI is the fastest path; the desktop app and the API client all wrap the same engine.

1. Install the CLI

The CLI is distributed as a single binary for macOS, Linux, and Windows.

# macOS · Homebrew
brew install filebase

# Linux · curl
curl -fsSL https://get.filebase.dev | sh

Verify the install:

filebase --version
# filebase 0.6.4

2. Authenticate

Sign in with your Filebase account. The token is stored in ~/.config/filebase/credentials.

filebase auth login
# → opens your browser
# ✓ Logged in as you@example.com

3. Sync a folder

Pick a local directory and link it to a remote root. Filebase watches it for changes and pushes block-level diffs in the background.

cd ~/projects
filebase init my-team
filebase sync

Excluding files

Add a .filebaseignore at the root of the synced folder. Same syntax as .gitignore:

node_modules/
*.log
build/

4. Where to go next

Read Conflict resolution to understand how Filebase merges concurrent edits, or skip to the CLI reference for the full subcommand list.