User Guide

How to use VibeOS

A practical, end-to-end guide to your VibeOS desktop — the apps, the AI, and the habits that make it feel like home.

DocsUser Guide
Chapter 01

Getting started

VibeOS lives entirely in your browser. There's nothing to install — sign in, launch an instance, and your desktop boots in seconds.

1

Create your account

Sign up with email from the landing page. You'll land on your dashboard, where every instance, team, and volume you have access to lives.

2

Launch your first instance

Click New Instance, name it, and pick a configuration. About five seconds later you're on the VibeOS desktop in a fresh tab.

3

Sign in once, stay signed in

Your session persists across tabs and devices. If you close the tab, your work syncs to VibeOS Cloud — open it later and pick up where you left off.

Bookmark os.vibeoscloud.com for one-click access to your desktop.
Chapter 02

The desktop

VibeOS looks and behaves like a real desktop OS. Windows tile, snap, and stack. The dock holds your favorites. The menubar lives at the top.

1

The dock

The dock at the bottom holds pinned apps. Click any icon to launch it. Right-click an app to pin or unpin.

2

Windows

Drag a window's title bar to move it. Drag an edge to resize. Use the traffic-light buttons to close, minimize, or zoom.

3

The menubar

The menubar at the top shows the active app's menus, system status, and your account. Click the VibeOS logo at any time to open the launcher.

4

Multi-tasking

Open as many apps as you like. Ctrl/⌘ + Tab cycles windows. Anything you minimize stays in the dock.

Chapter 03

Files & volumes

Everything you create lives in VibeFS, the cloud filesystem. There's no save button to worry about — changes sync as you work.

1

Open the Files app

Click the Files icon in the dock. You'll see your home folder with familiar locations like Documents, Downloads, and Desktop.

2

Drag, drop, organize

Drag files from your local machine straight into a folder to upload. Drag between folders to move. Right-click for cut, copy, paste, and rename.

3

Mount a volume

Volumes are persistent drives that survive even when the instance is stopped. Create one from the dashboard, then attach it from your instance profile — it shows up under /Volumes.

4

Trust the sync

Your filesystem is rehydrated from VibeOS Cloud on every boot. Switch devices freely — your tree, your files, your apps follow you.

Ask VibeAI to find, rename, or tidy your files in plain English: "Move all PDFs from Downloads to Documents/Receipts."
Chapter 04

Working with VibeAI

VibeAI is the assistant baked into every app. It sees your active app, your selection, and the files you reference — and it can take action, not just answer.

1

Open VibeAI

Click the VibeAI icon in the dock, or press Ctrl/⌘ + Space from anywhere.

2

Ask or command

Ask questions about a file, ask it to summarize, or tell it to do something: "Draft a reply to this email", "Create a 10-slide pitch deck about our launch", "Add a SUM formula to row 12".

3

Reference files

Drag a file into the chat or mention it by name. VibeAI can read it, modify it, and save the result back to VibeFS.

4

Pick a model

Switch between fast and high-accuracy models depending on the task. Usage is metered against your plan.

Where VibeAI shows up

  • Code — generate, refactor, and explain code in context.
  • Word — draft, rewrite, and change tone of any selection.
  • Spreadsheet — build formulas and analyze data from a prompt.
  • Slides — generate entire decks from a single description.
  • Mail — draft contextual replies in one click.
  • Terminal — type a plain-English request, get the right command.
  • PDF Viewer — summarize and ask questions about any open PDF.
  • Files — find, rename, and organize by description.
Chapter 05

Apps

Every VibeOS instance ships with the apps below, built for your needs. Click any card to open its detailed guide.

Developer / Power tools

More developer / power tools apps are on the way.

Chapter 06

Instances

An instance is one VibeOS desktop. You can have several — one for work, one for a side project, one for experiments. Instances are personal and aren't shared; collaborate by sharing volumes instead.

1

Create one

From the dashboard, click New Instance, give it a name, and launch.

2

Switch between them

Each instance opens in a new tab. The dashboard lists every instance you own.

3

Manage from the profile

Click an instance to open its profile — rename, attach volumes, or take snapshots.

4

One active session at a time

An instance can only be used in one tab at once. If you open it elsewhere, the older session is locked.

Chapter 07

Teams & sharing

VibeOS is built for collaboration without losing control. Share storage volumes with a person, a team, or no one at all.

1

Create a team

From the Teams page in the sidebar, click New Team and invite members.

2

Pick a role

Admins manage members and settings. Members can access shared volumes. Viewers have read-only access.

3

Share a volume

From a volume's profile, click Share. Add a user or team and choose Operator (read/write) or Viewer (read-only). Instances themselves are private to their owner — collaboration happens through shared volumes mounted into each person's instance.

4

Revoke anytime

Remove access from the same dialog. The volume will unmount from their instances on next sync.

Chapter 08

Snapshots & backups

A snapshot is a full backup of an instance — files, settings, installed apps — captured at a moment in time.

1

Take a snapshot

From the instance profile, click Create Snapshot and give it a name like "before refactor".

2

Restore

Open any snapshot in the list and click Restore. The instance reverts to that exact state.

3

Tidy up

Delete snapshots you no longer need to reclaim storage against your plan.

Chapter 09

App Center

The App Center is your launcher, installer, and publisher in one place. It holds three things: your installed custom apps, community-published apps, and a curated catalog of websites you can pin as web apps.

1

My Apps

See every custom app you've installed. Export an app as a .vibeapp file to share it, or remove it — uninstalling syncs with your dock and desktop automatically.

2

App Center

Browse community-published apps. Install in one click — apps run in sandboxed iframes with the VibeOS SDK injected, so nothing touches your system without going through VibeOS.

3

Add a website

Pick from a curated catalog organized by category (News, Sports, Entertainment, Social, Productivity, Tech, Education, Finance, Shopping), or paste any URL. The site becomes a pinned web app with its own dock icon.

4

Install a .vibeapp file

A .vibeapp file is a self-contained JSON manifest (name, icon, HTML, window size, optional file extensions). Open one or drag it into the App Center to install.

5

Publish your own

Build an app in the Code editor with HTML, CSS, and JS, then publish it from the App Center — to yourself, to a team, or publicly (public publishes go through review).

6

File associations

Custom apps can register file extensions. When you open a matching file from Files, VibeOS offers the custom app alongside built-in apps.

Chapter 10

Settings & shortcuts

Open the Settings app to change the theme, set a wallpaper, configure accessibility, and tweak per-app preferences.

Essential shortcuts

Open the app launcherCtrl / ⌘ + K
Open VibeAI from anywhereCtrl / ⌘ + Space
Save the active documentCtrl / ⌘ + S
Find inside the active appCtrl / ⌘ + F
Cycle between open windowsCtrl / ⌘ + Tab
Close menus, dialogs, or exit fullscreenEsc
Theme is set to System Auto by default — it follows your OS preference. Override it any time from Settings → Appearance.
Keep exploring

Related guides