Diff

Overview

The /diff command provides a comprehensive view of all uncommitted changes in your Git repository. Available exclusively in Git mode, it displays staged changes, unstaged modifications, and untracked files in an organized modal interface with syntax highlighting and interactive features. This command helps you review your work before committing or creating pull requests.

Quick Start

  1. Ensure you're running Friday in Git mode
  2. Type /diff in the Friday prompt
  3. Review your changes in the modal that appears
  4. Use the interactive features to open files or add diffs to your conversation
  5. Press Esc to close the modal

Usage

Basic Command

The /diff command requires no parameters. Simply type:

/diff

Friday will gather and display all uncommitted changes in your repository.

Understanding the Display

The diff modal organizes changes into two main sections:

Staged Changes

Files that have been added to the Git index using git add. These changes are ready to be committed.

Unstaged Changes

Modified tracked files and untracked files that haven't been staged yet. This includes both files that Git is tracking but have new modifications, and completely new files that haven't been added to Git.

File Status Indicators

Each file in the diff view includes a status indicator:

  • [U] (green) - Untracked file (new file not yet added to Git)
  • [M] (orange) - Modified file (existing file with changes)
  • [D] (red) - Deleted file (file removed from the repository)

Interactive Features

Each file section provides action buttons depending on the file status:

Edit

Opens the file in your configured editor. This allows you to make quick edits directly from the diff view. Any changes made will be automatically added to Friday's context.

Configure your preferred editor using the /settings command. Supported editors include:

  • Vim - Opens files directly for editing
  • VS Code - Opens files with diff view support
  • Cursor - Opens files with diff view support

Add to Chat

Adds the diff content to your conversation with Friday. This is useful when you want Friday to review specific changes, suggest improvements, or help you understand the impact of your modifications.

Review Changes Button

After Friday makes changes to your codebase, a "review changes" button appears in the conversation. Clicking this button opens the diff modal, allowing you to quickly review all modifications Friday has made.