Getting started
What Cloud Compass is, and how to begin.
What is Cloud Compass?
One place for your cloud storage: browse, search, organize, and tidy Google Drive, OneDrive, and Dropbox side by side. Your files stay with your providers; Cloud Compass shows and changes them there.
Which services can I connect?
Google Drive, OneDrive (personal Microsoft accounts), and Dropbox, up to five accounts at once. Microsoft work or school accounts are not supported yet. Apple iCloud and Proton Drive will follow once they offer sign-in for other apps.
Why does Google say the app is not verified?
Google reviews apps that ask to read Google Drive. Until Cloud Compass passes that review, Google shows a warning when you connect Drive (choose Advanced, then Go to CloudCompass, to continue) and lets only a limited number of people connect. Signing in with Google is not affected.
Who can sign in?
Whoever runs this Cloud Compass decides: only the addresses in OWNER_EMAILS, or anyone with a Google or personal Microsoft account when OPEN_SIGN_IN is on. When it is on, Sign up on the home page creates your account with Google or Microsoft; then you sign in. Each person sees only their own cloud accounts, collections, and settings. You sign in with Google, Microsoft, or a passkey; Cloud Compass never asks for a password.
Can I try it without connecting my accounts?
Yes. The demo signs you in as a made-up user with three made-up accounts. Every file is sample data held in memory; nothing is real and nothing leaves the computer.
Can I install it like an app?
Yes, where your browser offers it: choose Install the App… in the profile menu. On an iPhone, open it in Safari, tap Share, then Add to Home Screen.
Privacy and your data
What is kept, where, and what never leaves.
Does Cloud Compass store my files?
No. File lists and contents are read live from your providers and never stored. Cloud Compass keeps only your settings (account names, collections, preferences, and passkeys) on the computer that runs it.
Where are my account access keys kept?
Encrypted (AES-256-GCM) in cookies on your own device, not on the server. They are used only to talk to the provider each account belongs to.
Can Cloud Compass change or delete my files?
Only after you allow it. Each account starts read-only; the first time you rename, move, upload, or trash in an account, its provider asks you to grant permission, for that account alone. Nothing is ever deleted permanently: trash goes to the provider's own trash.
Does anything I do leave the app?
Only what Google, Microsoft, and Dropbox need to show and change your files. There are no analytics or third-party scripts. The AI Assistant runs in your browser and contacts no one.
How do I see what Cloud Compass has done?
Settings › Activity lists your changes (trash, renames, moves, uploads, and more), kept only in this browser, up to the last 200. You can filter or clear it.
How do I remove Cloud Compass's access completely?
Disconnect an account from its ⋯ menu on Overview, then revoke access at the provider (About Cloud Compass links to each provider's page). To remove everything, Settings › Delete account asks why you are leaving (kept without your name or email), then asks you to confirm, deletes your settings, and signs you out on every device; your files are not touched.
Accounts and signing in
Sessions, remembered accounts, and passkeys.
How long do I stay signed in?
You are signed out after 30 minutes without using Cloud Compass, and after 14 days at most.
Are my accounts remembered when I sign out?
On this device, yes, for 90 days, encrypted, so signing in again brings them back. On a shared or borrowed computer choose Sign Out… › Sign out and forget accounts here. Sign out on all devices ends every session.
How do I sign in with my fingerprint or face?
Add a passkey in Settings › Passkeys. Your device keeps the private key; Cloud Compass stores only the public part.
Why does an account say it needs reconnecting?
Its provider ended Cloud Compass's access, for example after a password change. Choose Reconnect from the account's ⋯ menu on Overview and sign in at the provider again.
Can I give an account my own name?
Yes: Rename in the account's ⋯ menu on Overview, such as Work or Family photos. The name shows everywhere in the app.
Files and changes
Trash, undo, uploads, and moving between accounts.
Is moving something to the trash permanent?
No. It goes to the provider's own trash (Google Drive's trash, the OneDrive recycle bin), where you can restore it, and the notice that appears offers Undo. Cloud Compass never deletes anything permanently.
Can I undo a rename or a move?
Yes. Renames, moves, and moves to trash each offer Undo in the notice that appears.
How large a file can I upload?
Up to 10 GB a file. Use Upload in Files, or drop files anywhere on the list. Large files go up in pieces, with progress.
How do I copy or move files to another account?
Select them in Files and choose Copy to…. The file passes through the server's memory, never its disk. A move puts the original in the first account's trash once the copy has arrived complete.
What happens when I download a Google Doc?
Google Docs, Sheets, and Slides download as Word, Excel, and PowerPoint files.
Why does Google ask for permission before a preview or download?
Google's read-only permission covers file names and details but not contents. Grant permission for that account once, or open the file at Google instead.
Can I save a place I visit often?
Yes: Views › Save this view… in Files keeps a folder or a search with its filters and sort, on every device you sign in on.
Collections and the Dashboard
Grouping files, and understanding your storage.
Are there ready-made collections?
Yes. Collections › Start from a template offers Taxes & finance, Home & bills, Travel, Recent work, Photos & videos this year, and Large files to review. Each creates a collection filled with up to 100 matching files from your accounts, found by name, type, date, or size; you can add or remove files afterwards.
Do collections move my files?
No. A collection is a list of shortcuts to files in any account; the files stay where they are. You can have up to 50 collections of up to 500 files each.
How is the storage health score worked out?
From how full your accounts are, the fullest counting most. Choose How is this worked out? under the score for the figures behind it; 100 means plenty of room.
How are duplicates found?
From the providers' own content checks, so two files count as copies only when their contents match. Cloud Compass never downloads files to compare them.
Can Cloud Compass tell me when an account will be full?
Yes. After a week, Storage by account on the Dashboard shows how fast each account grows and about when it fills. Cloud Compass keeps one used and total figure per account per day, for a year, and nothing about your files.
Can I set up rules to tidy up?
Yes, in Settings › Rules: for example, screenshots older than 30 days to an Archive folder, or archives over a year old to trash. After each scan a rule with matches shows up in the Dashboard's Suggestions; nothing moves or goes to the trash until you approve it there.
How do I find photos that look alike?
Photos › Similar photos groups bursts, edits, and resized copies, compared from their previews on your device (up to 1,000 photos). Select the ones you don't need and move them to trash, with Undo.
Can I keep a copy of the Dashboard?
Yes: Export › Download CSV, or Print or save as PDF.
The AI Assistant (Compass)
What it reads, where it runs, and how you stay in control.
Is the AI Assistant on by default?
No. It is off until you turn it on in Settings › AI Assistant › Overview, feature by feature, and it reads only the accounts you tick in Privacy.
Where does it run? Does my data go to an AI company?
Entirely in your browser, on this device. Nothing you type or say, and no file name, leaves Cloud Compass. Its models are downloaded once, by you, from Hugging Face with npm run ai:models; it never fetches them on its own.
What can it read?
The names and folders of files in the accounts you allow. It never reads folders and file types you choose under Never read. It reads a file's contents when you press Summarize with Compass, and, only if you turn on Privacy › Read what documents say, to search inside documents and answer questions about a file you choose. Then it keeps only encrypted numbers made from the text, never the text itself.
How do I keep sensitive details out of it?
Under Settings › AI Assistant › Privacy: list folders and file types it must never read, and keep Hide sensitive values on (the default), which masks card, ID, and bank numbers and key-like strings. Summaries also hide email addresses, phone numbers, and street addresses.
What does Compass remember?
Only facts you approve on a Remember card, and your conversations for as long as you choose: off, 7, 30, or 90 days (30 by default). See, edit, export, or delete them in Settings › AI Assistant › Memory. Nothing is kept unless AI_INDEX_KEY is set on the server.
Can Compass change my files?
It can prepare a move, rename, or trash, and nothing happens until you confirm it in the usual Cloud Compass dialog, with Undo afterwards. You can switch this off in Settings › AI Assistant › Conversation.
Is talking to Compass private?
Yes. Your speech is turned into text on this device; the microphone is on only while you hold it (or until you tap again), and audio is never kept or sent.
Which files can it summarize?
Text, PDF, Word, PowerPoint, and Excel files, including Google Docs, Sheets, and Slides, up to 20 MB, from their first 12,000 characters. Pictures, video, and sound are not supported yet. In Google Drive it needs the same permission as previews and downloads, which Cloud Compass asks for the first time.
How do I delete everything the AI has kept?
Settings › AI Assistant › Overview › Delete AI data removes the saved search index, remembered facts, and saved conversations. Your files are not touched.
Troubleshooting
Browsers, speed, and getting unstuck.
Which browsers are supported?
Current versions of Chrome, Safari, Edge, and Firefox. The AI Assistant is fastest in Chrome or Edge, which can use the graphics chip; elsewhere it still answers, more slowly.
Why is the AI Assistant's first answer slow?
The first chat in a tab loads Compass's model (about 1.8 GB) into the browser. Turn on Settings › AI Assistant › Models › Load Compass's model when the app opens to have it ready sooner.
A list looks out of date. What do I do?
Lists refresh themselves while the app is open; choose Refresh in Files, or Scan again on the Dashboard, to update straight away.
Is Cloud Compass available in other languages?
Not yet. It is in English; Hindi, Tamil, Telugu, Spanish, French, German, Japanese, and Mandarin are planned, one at a time. Compass will answer in a language only once it is measured to work well in it.
Are there keyboard shortcuts?
Yes. Press ? anywhere to see them all; Shift + A opens the AI Assistant.
Still have a question?
Ask Compass, the AI Assistant: open it with Shift + A and choose Get help. Or see everything Cloud Compass can do.