| sidebar_position | 12 |
|---|---|
| title | pull |
Pull changes from a remote.
atomic pull [OPTIONS] [REMOTE]The pull command downloads changes from a remote repository and applies them
to your local view. Atomic connects to the remote, determines which changes are
missing locally, downloads them, and applies them to the target view.
Atomic's pull operation is mathematically guaranteed to be conflict-free: patch theory ensures that changes can be applied in any order with consistent results.
If the target local view doesn't exist yet, pull creates it automatically
rather than failing — so pulling a teammate's view (or a brand-new view named
with --to-view) just works. When the target view is also your current view,
the working copy is materialized to reflect the pulled changes; when it's a
different view, the changes are applied to that view's change log and pull
prints a hint to atomic view switch <view> to check it out.
Remote name or URL to pull from. Passed positionally. If not specified, the default remote configured in the repository is used.
# Pull from default remote
atomic pull
# Pull from named remote
atomic pull origin
# Pull from a URL
atomic pull ssh://user@host/path/to/repoLocal view to pull into. If not specified, defaults to the remote view being
pulled (--from-view), so atomic pull --from-view X pulls into a local
view named X. The view is created automatically if it doesn't already
exist locally.
atomic pull origin --to-view feature-new-uiRemote view to pull from. If not specified, defaults to your current view.
atomic pull origin --from-view developShow what would be pulled without actually pulling.
atomic pull --dry-runPull all changes, not just those missing locally.
atomic pull --allSkip TLS certificate verification.
atomic pull -k https://insecure-server/repoRequest timeout in seconds. Defaults to 30.
atomic pull --timeout 60Download changes without applying them to the local view.
atomic pull --download-onlyIdentity to use for authentication.
atomic pull --identity work-v, --verbose— Emit extra diagnostic output.--no-color— Disable ANSI color in output.-h, --help— Print help.
# Pull from default remote
atomic pull
# Pull from a named remote
atomic pull origin
# Pull from upstream
atomic pull upstream# Pull the remote develop view into the current view
atomic pull origin --from-view develop
# Pull a remote view into a local view of the same name.
# --to-view defaults to --from-view, and the local view is created if missing.
atomic pull origin --from-view feature-auth
# Pull a remote view into a differently named local view
atomic pull origin --from-view feature-auth --to-view my-local-copy:::note View defaults and auto-creation
--from-view defaults to your current view, and --to-view defaults to
--from-view. If the target local view doesn't exist, pull creates it
instead of erroring with "View not found." Pulling into a view other than the
current one updates that view's change log without touching your working copy —
run atomic view switch <view> to check it out.
:::
# Preview what would be pulled
atomic pull origin --dry-run
# Pull all changes
atomic pull origin --all
# Download changes without applying them
atomic pull origin --download-only# Use a specific identity
atomic pull origin --identity work
# Increase the request timeout
atomic pull origin --timeout 60
# Pull from a custom remote URL
atomic pull ssh://contributor@server/repoatomic push- Push changes to a remoteatomic clone- Clone a remote repositoryatomic remote- Manage remotesatomic view- Manage views