Source Control
Git integration, branches, and the agents panel
Overview
Agentastic includes comprehensive Git integration for managing your repositories directly from the editor.
Source Control Navigator
Open the Source Control Navigator from the left sidebar to see:
- Changes - Modified, staged, and untracked files
- Branches - Local and remote branches
- Stashes - Saved work in progress
- Remotes - Connected remote repositories
Basic Operations
Viewing Changes
- Files with changes show status indicators in the Navigator
- Click a changed file to view the diff
- Staged and unstaged changes are shown separately
Staging & Committing
- Select files to stage in the Source Control Navigator
- Enter a commit message
- Click Commit or press Cmd+Enter
Branch Management
| Action | How To |
|---|---|
| Create Branch | Click + in Branches section |
| Switch Branch | Double-click a branch |
| Merge Branch | Right-click > Merge into current |
| Delete Branch | Right-click > Delete |
Agents Panel
Agentastic has first-class support for git worktrees via the Agents panel, allowing you to work on multiple branches simultaneously.
What are Agents?
Agents use git worktrees to let you check out multiple branches at once, each in its own directory. This is useful for:
- Reviewing PRs while working on features
- Quick bug fixes without stashing
- Comparing implementations across branches
- Running AI coding agents in isolated environments
Navigating Agents
| Action | Shortcut |
|---|---|
| Next Agent | Cmd+Option+Down |
| Previous Agent | Cmd+Option+Up |
Managing Agents
Access agent management in Settings > Agents:
- View all agents for the current repository
- Create new agents
- Switch between agents
- Remove unused agents
Diff Viewer
The diff viewer shows changes with syntax highlighting:
- Green - Added lines
- Red - Removed lines
- Navigate between changes with the diff controls
Stashing
Save work in progress without committing:
- Right-click in Source Control Navigator
- Select Stash Changes
- Enter an optional stash message
Apply stashes from the Stashes section of the Navigator.
Remote Operations
| Action | Description |
|---|---|
| Fetch | Download remote changes |
| Pull | Fetch and merge remote changes |
| Push | Upload local commits to remote |
Access these from the Source Control Navigator toolbar or the Source Control menu.