Git overview

Deskless includes a native Git workflow on every supported platform. The underlying implementation is selected for the operating system, while the product experience stays aligned: clone, inspect, branch, commit, pull, and push without leaving your project.

Git changes

Open the Git surface to see:

• the current branch and ahead/behind state;
• modified, added, deleted, and untracked files;
• a unified diff for each change;
• recent commits and their details; and
• available sync actions.

Everyday workflow

1. Edit one or more project files.
2. Open Git Changes and review the diff.
3. Stage the files you intend to include.
4. Write a clear commit message and commit locally.
5. Pull if the remote has moved, resolve any conflicts, then push.

Deskless checks the actual result of pull and push operations. A rejected update, merge conflict, or authentication failure is surfaced instead of being reported as a successful sync.

Branches

Create a branch before a focused change, switch between existing branches, and remove branches you no longer need. Deskless protects the active branch and asks for confirmation before operations that can discard uncommitted work.

Merge conflicts

When a pull or merge produces a conflict, inspect the affected files and choose the appropriate resolution. Depending on the conflict, you can keep your version, keep the incoming version, edit the result manually, or abort the merge. Review the final diff before committing.

Authentication

• HTTPS: use the username and personal access token required by your provider.
• SSH: import or generate a key, add the public key to your provider, and provide the passphrase when necessary.

Saved credentials use secure OS storage. Deskless removes credentials from URLs before displaying logs or errors.

Offline work

Local editing, diffs, branches, and commits do not require a network connection. Clone, fetch, pull, and push communicate directly with your configured remote and require connectivity.