Skip to main content
This command shows your project’s syncing status. It also contains the working tree directory, which includes the repository, branch, workspace, and commit you’re in.
[paths...] when specified, shows the sync status of the given files or directories (implies --sync-only and --nowait). [--sync-only] shows sync status only. [--nowait] exits without waiting for the workspace to be synced. [--commit-id-only] shows only the commit ID of the workspace. [--no-limit] shows the complete changelist without limiting the output size.

​
Reading the output

dv status reports two separate commits, and they answer different questions:
When both name the same commit, the files on your machine match your cloud workspace. The desktop app shows these same two facts in the workspace header, so you can read them there without running the command. By default dv status waits for the workspace to finish syncing before it returns. Pass --nowait to print the current state and exit immediately.

​
While a transfer is running

Outbound changes are files going up to the cloud; Inbound changes are files coming down. While Queued filesystem events is above zero the agent is still finding changes, so the totals can still grow.

​
When sync is stopped

A paused workspace neither sends nor receives files. Run dv workspace resume to restart it — see Pause/Resume sync. If the agent recorded a problem, its most recent one is printed as Last error: <message>.