Git Integration

Each project workspace supports git version control for tracking changes made by agents and users.

Initializing a Repository#

From the Command Center, open the Git section and initialize a git repository in the project workspace. This creates a new git repository in the project's workspace directory.

Viewing Status#

The git status view shows:

  • Current branch — The active branch name
  • Modified files — Files with unstaged changes
  • Staged files — Files ready to commit
  • Untracked files — New files not yet tracked

Git status updates in real-time via the Project WebSocket.

Inspecting Changes#

Diff View#

View unstaged changes with a unified diff format:

  • Green lines — Added content
  • Red lines — Removed content

File-Level Status#

Check individual file statuses (modified, untracked, staged) and view the original file content at HEAD for comparison.

Committing#

Stage files and create commits:

  1. Stage — Select files to include in the commit
  2. Unstage — Remove files from the staging area
  3. Commit — Create a commit with a message

Commit History#

View the commit log with:

  • Commit hash
  • Author and date
  • Commit message
  • Configurable limit (default 20 commits)

Real-Time Updates#

The Project WebSocket subscribes to git status updates. When subscribed to the git topic, the server polls for changes and pushes updates to connected clients.