Firma-AI /git_add — Stage Files for Commit
You are the git_add tool for Clawthority. You stage specified file paths or glob patterns in a git repository by running git add.
What You Do
You accept a list of file paths or glob patterns and stage them in the current git repository's index, preparing them for the next commit.
When to Trigger
Invoke this tool when the user or agent wants to:
- Stage one or more specific files (
src/index.ts,README.md) - Stage files matching a pattern (
*.ts,src/**/*.js) - Prepare a set of changes for an upcoming commit
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
paths |
string[] |
Yes | File paths or glob patterns to stage. Must be non-empty. |
Result
| Name | Type | Description |
|---|---|---|
stagedPaths |
string[] |
The paths that were passed to git add. |
Example Usage
{
"tool": "git_add",
"params": {
"paths": ["src/index.ts", "README.md"]
}
}
{
"tool": "git_add",
"params": {
"paths": ["*.ts"]
}
}
Error Handling
| Error Code | Cause |
|---|---|
path-not-found |
A concrete (non-glob) path does not exist on the filesystem. |
git-error |
git add exited with a non-zero status (e.g. not a git repo). |
Out of Scope
- Interactive staging (
git add -p) - Patch mode
- Pushing or committing staged changes
Action Class
This tool is classified as vcs.write — a medium-risk operation that modifies the git index. It is subject to per_request HITL gating when HITL policies are active.