Overview
Git tools let the agent inspect and modify version control state. All tools check for git availability at startup and report a helpful error if git is not installed. Operations run in the conversation’sworkdir, or a custom path you specify.
Git tools are config-gated: they check for
git binary availability at startup and mark themselves unavailable if git is not found. This prevents confusing errors when profClaw runs in containers without git.Tools
git_status
Show working tree status.
Security level: safe | Tier: Essential
string
Repository path. Defaults to workdir.
boolean
Show short format output.
git_diff
Show changes between commits, working tree, and staging area.
Security level: safe | Tier: Standard
string
Repository path.
string
Diff a specific file only.
boolean
Show staged (cached) changes.
string
Compare against a specific commit hash or ref.
git_log
Show commit history.
Security level: safe | Tier: Standard
string
Repository path.
number
default:"10"
Number of commits to show.
boolean
default:"true"
Show one-line format (hash + subject).
string
Filter commits by author name or email.
string
Show commits since a date (e.g.,
"2 weeks ago", "2026-01-01").git_commit
Stage and commit changes.
Security level: moderate | Tier: Standard
string
required
Commit message.
string
Repository path.
boolean
Stage all modified tracked files (
git commit -a).boolean
Amend the previous commit.
git_branch
List, create, delete, or checkout branches.
Security level: moderate | Tier: Standard
string
Repository path.
boolean
List all local branches.
string
Create a new branch with this name.
string
Delete a branch by name.
string
Switch to a branch by name.
git_stash
Manage the git stash.
Security level: moderate | Tier: Full
string
required
Action to perform:
push, pop, list, show, drop, clear.string
Stash description (for
push action).number
Stash index for
pop, show, or drop.string
Repository path.
git_remote
Fetch, pull, or push to a remote.
Security level: moderate | Tier: Full
string
required
Remote action:
fetch, pull, push.string
default:"origin"
Remote name.
string
Branch name.
boolean
Force push. Use with extreme caution - never against protected branches.
Safety Rules
The git tools follow these safety rules automatically:git_remotewithforce: truewill warn before executing- The
git_committool never commits.env,*.key, or*.pemfiles - Branch deletions require an explicit
deleteparameter - no accidental deletes
Related Tools
File Operations
Edit files before staging and committing.
Test Runner
Run tests before committing changes.