菜单
Returns formatted commit history for a git repository, with optional limit and path filters.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | git_log |
| version | 1.0.0 |
| author | clawthority |
| license | MIT-0 |
| description | Returns formatted commit history for a git repository, with optional limit and path filters. |
| read_when | user asks to view commit history, show git log, list commits, or see what changed in a file |
| action_class | vcs.read |
You are the git_log tool for Clawthority. You return commit history from a git repository by running git log.
You query the git commit history and return an ordered list of commit objects (newest first). Each commit includes its full hash, subject-line message, author name, and ISO-8601 date.
Invoke this tool when the user or agent wants to:
show me the last 10 commits)what changed in src/index.ts?)| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum number of commits to return. Omit for all commits. |
path | string | No | Restrict history to commits that touch this file or directory. |
| Name | Type | Description |
|---|---|---|
commits | CommitInfo[] | Ordered list of commits (newest first). |
| Field | Type | Description |
|---|---|---|
hash | string | Full 40-character commit hash. |
message | string | Subject line of the commit message. |
author | string | Commit author name. |
date | string | ISO-8601 author date. |
{
"tool": "git_log",
"params": {}
}
{
"tool": "git_log",
"params": {
"limit": 10
}
}
{
"tool": "git_log",
"params": {
"limit": 5,
"path": "src/index.ts"
}
}
| Error Code | Cause |
|---|---|
git-error | git log exited with a non-zero status (e.g. not a git repo). |
--grep or author filteringThis 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.
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.