grit pull
Description
Runs grit fetch, then merges the remote's copy of the current branch into it, as grit merge would: a fast-forward when you have no new commits of your own, and a merge commit when both sides do. On a branch with no commits yet, it simply takes the remote's.
The remote is the one in branch.<name>.remote, or origin. The remote branch is the one in branch.<name>.merge, or the branch with the same name as yours.
Like grit merge, grit pull won't run with uncommitted changes or a detached HEAD, and stops without changing anything if there are conflicts.
Options
grit pull takes no options beyond the global ones.
JSON output
The same shape as grit merge. Pass --json for stable, scripting-friendly output:
| Field | Type | Meaning |
|---|---|---|
result |
string | up_to_date, fast_forward, merged, or set_upstream. |
branch |
string | Remote branch that was integrated. |
oid |
string or null | Commit the current branch points at after the pull, when applicable. |
upstream |
string or null | For set_upstream, the remote-tracking branch that was adopted. |