Skip to content

Git & Version Control

Ptah treats git as a first-class part of your workspace. Every open workspace that contains a .git/ directory gets:

  • A real-time git watcher — no polling, no manual refresh.
  • Live branch name, commit hash, and dirty-state indicators in the UI.
  • Agent-aware context that adapts to the current branch.
  • Tooling for worktrees, diffs, and conventional commits.

The integration is read-first. Agents can propose commits, branch switches, and worktree operations, but destructive actions always require your confirmation.

Git status

Real-time .git watcher surfacing branch, commit, and dirty state.

Worktrees

Parallel development with git worktree — ideal for agent-driven branches.

Diffs

Side-by-side file change display with syntax highlighting.

Commits

Agent-assisted conventional commits with commitlint enforcement.

Branch awareness

How agent context adapts when you switch branches.

FeatureWhere to find it
Current branchStatus bar, bottom-left
Short commit hashStatus bar, next to branch
Dirty indicatorOrange dot next to branch when uncommitted changes exist
Diff viewerClick any modified file in the file tree
Worktree panelView → Git Worktrees
Commit composerChat command /commit or Git → Commit changes