Dropbox integration (file browser and management)
A Dropbox file browser inside Omniscio: connect your account once, then browse, search, upload, download, rename and delete files from a sidebar panel, with the account token kept in your operating system's credential store.
On this page
What it is
Omniscio's Dropbox integration is a sidebar file browser for browsing, uploading, downloading, and managing files in your Dropbox account. It connects via Dropbox's REST API v2 using OAuth2 + PKCE (no SDK dependency). The integration follows the channel-adapter pattern: it gets its own virtual project in the sidebar and renders a dedicated file-browsing panel.
Where to find it
How to use it
- Enable Dropbox. Settings > Dropbox > toggle
dropboxEnabledon. - Connect your account. In the Dropbox settings panel, click Connect Dropbox. A browser window opens for Dropbox OAuth consent; Omniscio catches the redirect, encrypts the refresh token via
safeStorage, and stores it. - Browse files. Click the Dropbox tile in the sidebar. The file browser shows your root folder with breadcrumb navigation, search, and folder creation.
- File actions. Each file row has hover-reveal actions: download, rename, copy shared link, and delete (with confirmation dialog). Folders are clickable to navigate into. The dialog guards this panel only — see the warning below before you hand the CLI token to anything.
Anything holding the CLI token can delete, move or share these files without asking. Omniscio's CLI exposes the same operations — rename, move, copy, delete, and create a public share link — and they apply immediately: no confirmation dialog, no approval card, just the token. A script you run, or an agent session you have started, that holds the token can therefore delete or move a Dropbox file, or mint a link that anyone on the internet can open, and you will not be asked first. Deletion is final. Treat the CLI token as the keys to your Dropbox account: keep it to yourself, regenerate it in Settings → CLI Control if it leaks, and prefer the panel's hover actions when you want to see an action before it happens.
How it behaves
How it works
Auth: OAuth2 + PKCE flow via openOAuthPopup() in dropbox-auth-service.ts. Refresh tokens are encrypted at rest via the config store's CREDENTIAL_FIELDS. Token refresh supports rotation (Dropbox may issue a new refresh token on each use). If Dropbox ever completes a sign-in without handing back a refresh token, Omniscio reports that the sign-in did not finish and saves nothing, so an existing connection is never replaced by an empty one.
API: Direct globalThis.fetch() against Dropbox v2 REST endpoints (RPC-style POST JSON to api.dropboxapi.com/2/ for metadata, content.dropboxapi.com/2/ for content). All calls route through dropboxApiCall() which handles 401 auto-retry with token refresh. Implemented in dropbox-api-service.ts with 14 operations: list, list-continue, get, get-content, download, create-folder, upload, delete, move, copy, rename, create-shared-link, search, and get-storage-quota.
IPC: 17 typed channels with Zod validation + wrapHandler() + output validation in dropbox-handlers.ts. Error humanization via friendlyDropboxError().
Renderer: Zustand store in dropbox/ with DropboxProjectView (top-level), DropboxHeader (breadcrumbs + search + actions), DropboxFileList (file listing with pagination), and DropboxFileItem (row with hover-reveal actions using ListItem).
Settings: Own section in Settings > Connections > Dropbox with enable toggle and connection management.
Virtual project: Sentinel DROPBOX_PROJECT_ID = '__dropbox__' in the channel-virtual-projects system. Dashboard routing uses custom isDropboxSelected detection before the generic isChannelProject check (same pattern as Google Drive).
Settings flag: dropboxEnabled in channels-settings.ts.
Related
- INDEX.md — full library index
- drive-integration.md — Google Drive integration (similar file management, different provider)
Last verified 2026-10-06