Reference for the git default tool: git_status, git_diff, git_commit, git_log, and git_branch.

Git Tool

Script: powers/git.py Dependencies: pydantic

Interact with Git repositories -- check status, view diffs, commit changes, browse history, and manage branches. All operations use the git CLI under the hood.

git_status

Get the current status of a Git repository, including staged, unstaged, and untracked files.

Input

Field	Type	Default	Description
`working_dir`	`str`	`"."`	Path to the Git repository

Output

Field	Type	Description
`ok`	`bool`	`true` if status was retrieved
`branch`	`str`	Current branch name
`staged`	`list`	Files staged for commit: `{file, status}`
`unstaged`	`list`	Modified but unstaged files: `{file, status}`
`untracked`	`list`	Untracked file paths
`error`	`str`	Error message on failure

Status values: "modified", "added", "deleted", "renamed"

Examples

// Check status of current repo
{"working_dir": "."}

// Check a different repo
{"working_dir": "/path/to/repo"}

Example Output

{
  "ok": true,
  "branch": "feature/new-tool",
  "staged": [
    {"file": "src/main.py", "status": "modified"}
  ],
  "unstaged": [
    {"file": "README.md", "status": "modified"}
  ],
  "untracked": ["new_file.py"]
}

git_diff

Show changes in a Git repository. Can show unstaged changes, staged changes, or diff against a specific ref.

Input

Field	Type	Default	Description
`working_dir`	`str`	`"."`	Path to the Git repository
`staged`	`bool`	`false`	Show staged (cached) changes instead of unstaged
`file`	`str`	`null`	Limit diff to a specific file
`ref`	`str`	`null`	Diff against a specific ref (branch, tag, commit)

Output

Field	Type	Description
`ok`	`bool`	`true` if diff was retrieved
`diff_text`	`str`	Full diff output
`files`	`list`	Per-file statistics: `{path, additions, deletions}`
`error`	`str`	Error message on failure

Examples

// Unstaged changes (default)
{"working_dir": "."}

// Staged changes
{"staged": true}

// Diff against main branch
{"ref": "main"}

// Diff for a specific file
{"file": "src/main.py"}

// Staged changes for one file
{"staged": true, "file": "config.yaml"}

git_commit

Create a Git commit. Can stage specific files or all changes before committing.

Input

Field	Type	Default	Description
`message`	`str`	required	Commit message
`files`	`list`	`null`	Specific files to stage and commit
`all`	`bool`	`false`	Stage all changes before committing (`git add -A`)
`working_dir`	`str`	`"."`	Path to the Git repository

Output

Field	Type	Description
`ok`	`bool`	`true` if commit succeeded
`hash`	`str`	Full commit hash
`message`	`str`	Commit message used
`files_changed`	`int`	Number of files changed in the commit
`error`	`str`	Error message on failure

Examples

// Commit specific files
{"message": "Fix bug in parser", "files": ["src/parser.py", "tests/test_parser.py"]}

// Commit all changes
{"message": "Update all configs", "all": true}

// Commit already-staged changes
{"message": "Add new feature"}

Notes

If files is provided, those files are staged (git add) before committing
If all is true, git add -A is run before committing
If neither files nor all is set, only already-staged changes are committed

git_log

Show the commit history of a Git repository.

Input

Field	Type	Default	Description
`n`	`int`	`10`	Number of commits to show
`ref`	`str`	`null`	Branch, tag, or commit ref to start from
`working_dir`	`str`	`"."`	Path to the Git repository

Output

Field	Type	Description
`ok`	`bool`	`true` if log was retrieved
`commits`	`list`	Array of commit objects (see below)
`error`	`str`	Error message on failure

Each commit object:

Field	Type	Description
`hash`	`str`	Full commit hash
`author`	`str`	Author name
`date`	`str`	Commit date (ISO format)
`message`	`str`	Commit subject line

Examples

// Last 5 commits
{"n": 5}

// Last 20 commits on main
{"n": 20, "ref": "main"}

// History of a different repo
{"working_dir": "/path/to/repo"}

git_branch

Manage Git branches -- list, create, switch, or delete.

Input

Field	Type	Default	Description
`action`	`str`	`"list"`	Action to perform: `"list"`, `"create"`, `"switch"`, or `"delete"`
`name`	`str`	`null`	Branch name (required for create/switch/delete)
`working_dir`	`str`	`"."`	Path to the Git repository

Output

Field	Type	Description
`ok`	`bool`	`true` if operation succeeded
`branches`	`list`	Branch list (for `list` action): `{name, is_current, is_remote}`
`current`	`str`	Current branch name (after any action)
`error`	`str`	Error message on failure

Examples

// List all branches
{"action": "list"}

// Create and switch to new branch
{"action": "create", "name": "feature/new-thing"}

// Switch to existing branch
{"action": "switch", "name": "main"}

// Delete a branch
{"action": "delete", "name": "old-branch"}

Notes

create uses git checkout -b (creates and switches to the new branch)
delete uses git branch -d (safe delete -- fails if branch is not merged)
list includes both local and remote branches

Tips

Use git_status before git_commit to see exactly what will be committed
Use git_diff with staged: true to review staged changes before committing
Pair git_log with git_diff using a ref to see what changed between branches
All operations have a 30-second timeout to prevent hanging
These tools require git to be installed and the working directory to be inside a Git repository

Git Tool

On this page