Skip to main content

Git changes

Every workspace has a Git view that shows the uncommitted changes in its worktree and lets you commit a chosen subset of them.

Open it from the Commit tab of the selected Desktop workspace. On Mobile it is the Git tab, which follows the workspace selected on the Workspaces tab.

Reading the change list

Changed files are grouped by directory and indented, the same way a commit window shows a project in directory mode. Directories are listed before files, and each file carries a marker for its change kind:

MarkerMeaning
MModified
+Added
?Untracked
Deleted
Renamed
!Conflicted

Each untracked file gets its own row under its directory. Git alone would collapse a new directory into a single entry, so listing the files individually lets you select exactly the new files you want.

Selecting a file name opens its diff in a modal. Close the modal to return to the list. Binary files report that no text diff is rendered instead of showing raw bytes.

Choosing what to commit

Each file has a checkbox, and only checked files are committed. The list starts with a Changes checkbox that selects or clears every file at once. A directory checkbox selects or clears every file beneath it, and it shows as checked exactly when all of its files are selected.

The change list refreshes on its own while the Git view is open and keeps the checkboxes for files that are still present. Discard asks you to confirm the selected paths, then restores selected tracked files from HEAD and deletes selected untracked files.

Branch switching lives on the Overview tab, not in the Git view. A dropdown at the top of Overview shows the live branch, lets you switch to another local branch, and has a + control that opens a field to create a branch from the current HEAD. Switching refuses to run when Git itself would refuse, such as when the worktree has conflicting changes.

Committing

Type a message in the box below the list and choose Commit. The button stays disabled until at least one file is selected and the message is not empty.

Agent-Up stages every selected path with git add and then commits only those paths that still exist in the worktree. New files that disappeared after they were staged are dropped from the commit instead of failing the whole operation. Changes to files you did not select stay in the worktree untouched, so you can make several focused commits from one set of changes. After a successful commit the message box clears, the short commit hash is reported, and the change list reloads.

Commits use the Git identity configured for that repository or for the user running Agent-Up Server. If no identity is configured, Git rejects the commit and Agent-Up shows the reason.