Skip to main content
CodeFire provides comprehensive git and GitHub integration, giving you full visibility into your repository without switching to the terminal or browser.

​
Git Changes View

The Git tab shows your working directory status:
Git integration with commits, staged changes, and diffs

​
Three-Section Layout

  1. Staged Changes — Files ready to commit (green)
  2. Changes — Modified or deleted files (orange)
  3. Untracked — New files not yet tracked by git (gray)
Each section is collapsible with a count badge.

​
File Status Indicators

  • 🟢 Modified (M) — File has been changed
  • 🔴 Deleted (D) — File has been removed
  • 🟡 Added (A) — New file staged for commit
  • ⚪ Untracked (?) — New file not yet staged

​
Inline Diffs

Click any file to see an inline diff:
  • Line numbers for old and new versions
  • 🟢 Green background for additions
  • 🔴 Red background for deletions
  • ⚪ Gray for context lines
Scroll horizontally for long lines. The diff panel supports:
  • Syntax-aware line prefixes (+, -, )
  • Side-by-side line numbers (old | new)
  • Collapsible sections
Click the same file again to close the diff panel and free up space.

​
Staging Workflow

​
Stage Individual Files

Click the + button next to a file to stage it.

​
Unstage Files

Click the − button next to a staged file to unstage it.

​
Bulk Actions

  • Stage All — Stages all unstaged and untracked files
  • Unstage All — Removes all files from the staging area

​
Commit Composer

The Git tab includes a built-in commit interface:
  1. Stage the files you want to commit
  2. Write a commit message in the text editor
  3. Click Commit
CodeFire validates that:
  • At least one file is staged
  • Commit message is not empty
The commit runs in the background using git. CodeFire refreshes the changes view automatically after a successful commit.

​
Recent Commits

The Git tab shows the last 10 commits:
  • SHA (short hash)
  • Commit message
  • Relative time (e.g., “2h ago”, “yesterday”)
Click a commit to view details (planned feature).

​
GitHub Integration

If GitHub CLI (gh) is installed and authenticated, CodeFire displays:

​
Pull Requests

  • PR number and title
  • Author and branch
  • Draft badge if applicable
  • +/− line counts (additions/deletions)
  • CI status (passing, failing, pending)
  • Review status (approved, changes requested, review required)
Click a PR to open it in your browser.

​
CI / Workflows

  • Workflow name and status
  • Branch and event (push, pull_request, etc.)
  • Timestamp (relative time)
  • Status icon:
    • ✅ Success (green)
    • ❌ Failure (red)
    • ⏳ Pending (orange)
    • 🚫 Cancelled (gray)
Click a workflow to view details in GitHub.

​
Issues

  • Issue number and title
  • Labels (with color coding)
  • Timestamp (relative time)
Click an issue to open it in your browser.
GitHub PRs, CI, and issues

​
Setup GitHub Integration

Install and authenticate GitHub CLI: 
brew install gh
gh auth login
CodeFire automatically detects when gh is available and starts polling for:
  • Open pull requests
  • Recent workflow runs
  • Issues assigned to you
Polling happens every 30 seconds while the project window is active.
GitHub data is cached to minimize API requests. Refresh manually by clicking the refresh button in the header.

​
Branch Information

The Git header displays:
  • Current branch name
  • Change count (staged + unstaged + untracked)
  • Refresh button to manually re-scan
Sessions in the Sessions tab show which branch they ran on, making it easy to correlate work.

​
Best Practices

Don’t use “Stage All” blindly. Review each file’s diff to ensure you’re committing only what you intend.
CodeFire doesn’t enforce commit message conventions, but consider using:
  • feat: for new features
  • fix: for bug fixes
  • refactor: for code improvements
  • docs: for documentation
Use the CI / Workflows section to ensure tests pass before merging PRs.
For simple commits (typos, small fixes), use CodeFire’s commit composer. For complex commits (rebasing, cherry-picking), use the terminal.

​
Diff Viewer

CodeFire’s diff viewer supports:
  • Horizontal scrolling for long lines
  • Line-level highlighting (additions, deletions, context)
  • Line numbers (old and new)
  • Monospace font for alignment

​
Diff Format

Diffs use git’s unified diff format: 
@@ -10,7 +10,8 @@
   context line
-  removed line
+  added line
   context line
CodeFire parses this and renders:
  • − prefix for removed lines (red background)
  • + prefix for added lines (green background)
  • No prefix for context lines (gray)

Session Monitoring

See which git branch each session ran on

Terminal

Run git commands directly in the integrated terminal

Project Management

Each project tracks its own git repository

Task Tracking

Link commits to tasks for traceability

Build docs developers (and LLMs) love

Get started for freeTalk to us