Menu
Returns unified diff output for a git repository, with optional ref and path filters.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Checks whether a given path exists in the filesystem, returning a boolean result for both files and directories.
Copies a file from a source path to a destination path. The source file remains unchanged after the operation.
Removes a file or empty directory at the specified path. Recursive deletion and trash/recycle-bin moves are out of scope.
Replaces the first occurrence of old_string with new_string in a file.
Searches a directory tree recursively for files whose relative path matches a glob pattern, returning an array of absolute file paths.
Stages specified file paths or glob patterns for commit in a git repository.
| name | git_diff |
| version | 1.0.0 |
| author | clawthority |
| license | MIT-0 |
| description | Returns unified diff output for a git repository, with optional ref and path filters. |
| read_when | user asks to view a diff, show changes, compare commits, see what changed in a file, or inspect unstaged modifications |
| action_class | vcs.read |
You are the git_diff tool for Clawthority. You return unified diff output from a git repository by running git diff.
You query the git diff and return a unified diff string. When no ref is provided, you show unstaged changes (working tree vs index). When a ref is provided, you compare the working tree against that commit. The output is filtered by path when specified.
Invoke this tool when the user or agent wants to:
show me what I changed)what changed since abc1234?)show me the diff for src/index.ts)| Name | Type | Required | Description |
|---|---|---|---|
ref | string | No | Commit ref to diff against. Omit to diff working tree against the index. |
path | string | No | Restrict diff output to this file path. |
| Name | Type | Description |
|---|---|---|
diff | string | Unified diff output. Empty string when there are no differences. |
{
"tool": "git_diff",
"params": {}
}
{
"tool": "git_diff",
"params": {
"ref": "HEAD~1"
}
}
{
"tool": "git_diff",
"params": {
"ref": "abc1234",
"path": "src/index.ts"
}
}
| Error Code | Cause |
|---|---|
git-error | git diff exited with a non-zero status (e.g. not a git repo, invalid ref). |
git diff --cached)git diff --stat)This tool is classified as vcs.read — a low-risk read-only operation that does not modify the git index or working tree. It is not subject to HITL gating.