# Agent:Branches

**Page:** api/agent-branches

[Download Raw Markdown](./api/agent-branches.md)

---

## API Endpoints Summary

- **GET** `/api/branches` — List all branches
- **POST** `/api/branches` — Create a new branch
- **GET** `/api/branches/disk-usage` — Get branch disk usage
- **GET** `/api/branches/remote` — Get remote info
- **GET** `/api/branches/remote-refs` — List remote branches/tags
- **PATCH** `/api/branches/{id}` — Rename branch display name
- **DELETE** `/api/branches/{id}` — Delete a branch
- **POST** `/api/branches/{id}/reset` — Reset branch to base
- **POST** `/api/branches/{id}/retry` — Retry failed branch
- **GET** `/api/branches/{id}/diff` — Get branch diff
- **POST** `/api/branches/{id}/merge` — Merge branch
- **GET** `/api/branches/{id}/status` — Get branch git status
- **POST** `/api/branches/{id}/push` — Push branch to remote
- **POST** `/api/branches/{id}/pull` — Pull from remote
- **GET** `/api/branches/{id}/remote-status` — Get remote tracking status
- **GET** `/api/branches/{id}/pr` — Get PR/MR status
- **POST** `/api/branches/{id}/pr` — Create pull/merge request

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```