Skip to main content
FlowDeck includes source control in the Changes tab of the Inspector — the right-side panel. Review your diff, stage files, commit, and push without leaving the app.

​
Opening the Changes tab

Click the Inspector button in the top-right toolbar to open the Inspector, then select the Changes tab. The Changes tab is the default view when the Inspector opens.

​
Reviewing changes

The Changes tab shows all modified, added, and deleted files in the working tree. Click any file to see its diff inline. Files are marked as Viewed or Not Viewed — use this to track your code review progress across a large diff.

​
Staging and committing

Right-click any file to Stage or Unstage it. Then:
  1. Review staged files
  2. Type a commit message
  3. Click Commit
To discard changes in a file, right-click and choose Discard Changes — this is destructive and cannot be undone. In the full review window, Discard all changes applies to the complete working tree after confirmation, including binary files that do not appear in the text-diff list. If the repository changes while the confirmation is open, FlowDeck safely cancels the operation and asks you to review again. If any file cannot be discarded, FlowDeck reports that changes remain in the worktree; return to the Changes tab to review them.

​
Syncing with remote

The Changes tab shows your branch’s relationship to its remote tracking branch and surfaces the right action:
  • Fetch — when your branch is up to date
  • Pull — when behind the remote
  • Push — when ahead of the remote
  • Sync — when branches have diverged (fetch + pull + push)
  • Publish — when the local branch has no upstream tracking branch yet

​
Upstream commits

The Changes tab also shows recent upstream commits so you can see what’s changed on the remote without leaving FlowDeck.

​
Connect GitHub

Connect GitHub from Settings → GitHub or the GitHub option in Add Project. FlowDeck uses the connection to browse repositories, clone a selected repository, and create or monitor GitHub pull requests. You can also paste an HTTPS, SSH, or SCP-style repository address into the clone flow; FlowDeck normalizes a supported address before cloning. GitHub-specific features are unavailable until you connect, and pull-request automation does not apply to other forges. Disconnect from Settings when you no longer want the app to use the connection.

​
Pull requests and PR Autopilot

After publishing your branch, use Open PR in the Changes tab to create a GitHub pull request. The first time FlowDeck creates a PR successfully, it introduces PR Autopilot and lets you choose:
  • One-click commits and PRs: Generate context-aware commit and PR messages, commit your changes, and open the PR for you.
  • Monitor PRs: Keep watching for failing checks and merge conflicts so the same agent and context can fix them autonomously, even while you are away.
  • Auto-merge PRs: Appears after you enable monitoring and merges monitored PRs automatically once their checks pass.
Choose Save choices to apply the selected options, or Maybe later to leave your current settings unchanged. You can change all three options later in Settings > Workflows > Git. Turning off Monitor PRs also turns off and hides Auto-merge PRs. Monitor and auto-merge are settings, not permission to bypass an approval request for a remote change.

​
Using the agent

The agent will not commit or push without your explicit approval — changes always land in the Changes tab for you to review first.
The agent never pushes to a remote without asking you first, even when running in fully autonomous mode.