> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravixlayer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Git Add

> Stage files for commit (git add)

```python theme={null}
from gravixlayer import GravixLayer

client = GravixLayer()
runtime = client.runtime.create(template="python-3.14-base-small")

runtime.git.clone(
    url="https://github.com/octocat/Hello-World.git",
    path="/home/user/repo",
)

runtime.file.write("/home/user/repo/note.txt", "hello\n")

# Stage specific paths
r = runtime.git.add("/home/user/repo", paths=["note.txt"])
print(r.success, r.exit_code)

# Omit paths to stage all changes (equivalent to git add -A)
r = runtime.git.add("/home/user/repo")
print(r.success)

runtime.kill()
```

## Parameters

| Parameter         | Type           | Required | Description                                                                  |
| ----------------- | -------------- | -------- | ---------------------------------------------------------------------------- |
| `repository_path` | string         | Yes      | Path to the repository root inside the runtime                               |
| `paths`           | list of string | No       | Paths relative to the repo root to stage; if omitted, all changes are staged |

## Response

| Field       | Type    | Description                                    |
| ----------- | ------- | ---------------------------------------------- |
| `success`   | boolean | Whether the git command completed successfully |
| `exit_code` | integer | Process exit code from `git`                   |
| `stdout`    | string  | Standard output from `git`                     |
| `stderr`    | string  | Standard error from `git`                      |
| `error`     | string  | Error message when the operation fails         |