Overview
Captain's Deck automatically detects Git repositories and displays status information directly in the file list. No configuration required—just navigate to a Git repo and you'll see status indicators appear.
Status Indicators
Files in a Git repository show color-coded status badges:
| M | Modified — File has been changed since last commit |
| A | Added — New file staged for commit |
| D | Deleted — File has been deleted |
| ? | Untracked — New file not yet added to Git |
Directories also show aggregate status—a folder displays the "highest priority" status of its contents (e.g., if any file inside is modified, the folder shows as modified).
Branch Display
The current Git branch is displayed in the pane header when you're inside a repository. This lets you always know which branch you're working on.
Tip: Click the branch name in the header to quickly see branch information.
Context Menu Actions
Right-click on files to access Git actions:
- Stage — Add file to staging area (
git add) - Unstage — Remove file from staging area (
git reset) - Revert — Discard changes and restore to last commit (
git checkout) - Diff — View changes compared to HEAD
You can select multiple files and perform these actions in batch.
Git Status Panel
Open the Git Status Panel with Cmd + Shift + G for a comprehensive view of your repository:
- Changed Files — See all modified, added, and deleted files in one list
- Staged Changes — View what's ready to be committed
- Stage All / Unstage All — Quickly stage or unstage everything
- Commit — Write a commit message and commit directly
Double-click any file in the panel to open a visual diff.
Visual Diff
Captain's Deck includes a side-by-side diff viewer to see exactly what changed:
- Select a modified file
- Right-click and choose Diff, or press Cmd + D
- View additions (green), deletions (red), and modifications
The diff viewer shows the file compared against HEAD by default. Use keyboard shortcuts to navigate between changes:
| ] | Jump to next change |
| [ | Jump to previous change |
| Esc | Close diff viewer |
Common Workflows
Quick Commit
- Make changes to your files
- Press Cmd + Shift + G to open Git Status Panel
- Review changed files, click Stage All
- Enter commit message and click Commit
Selective Staging
- Select specific files you want to commit
- Right-click and choose Stage
- Open Git Status Panel and commit only staged files
Review Changes Before Commit
- Open Git Status Panel
- Double-click each modified file to view diff
- Stage files you want to include
- Commit when ready
Keyboard Shortcuts
| Cmd + Shift + G | Open Git Status Panel |
| Cmd + D | View diff for selected file |