Git Information

Last updated: 2026-08-05

Overview

Dev WorkDir shows Git branch information directly on project cards. See what branch you’re on without opening Terminal.

What You See

On Project Cards

Each project card shows:

  • Current branch name — e.g., main, feature/new-ui
  • Branch icon — a small git branch indicator
  • Worktree indicator — if the project is a git worktree

In Detail View

Select a project for more Git info:

  • Current branch
  • Whether it’s a worktree
  • Worktree path (if applicable)

How It Works

Pure File Reading

Dev WorkDir reads Git information by directly reading the .git/HEAD file. It does not use the git command.

Why this approach?

  1. Sandbox-compatible — App Sandbox can’t run arbitrary git commands
  2. Fast — Just reading a file, no process spawning
  3. Safe — Read-only, never modifies anything

Worktree Detection

Git worktrees are fully supported. Dev WorkDir detects worktrees by reading the .git file (which is actually a pointer file in worktrees) and shows the worktree name.

Limitations

What We Show

  • ✅ Current branch name
  • ✅ Worktree detection
  • ✅ Worktree name/path

What We Don’t Show (Yet)

  • ❌ Uncommitted changes status
  • ❌ Stash count
  • ❌ Remote tracking info
  • ❌ Commit history

These features may be added in future versions.

Tips

1. Quick Branch Check

Wondering what branch you’re on? Just glance at the project card. No Terminal needed.

2. Worktree Management

If you use git worktrees for parallel development:

  • Each worktree shows up as its own project
  • The worktree name is clearly displayed
  • Switch between worktrees from the menu bar

Perfect for:

  • Working on a feature while also reviewing a PR
  • Testing multiple approaches simultaneously
  • Keeping main clean

3. Git + Todos

See a branch and remember you need to fix something?

  1. Click the project
  2. Add a todo
  3. Done. It’s tied to the project.

Git info at a glance. No terminal required.