diffmanifests

# diffmanifests Skill (OpenClaw)

Use the **diffmanifests** CLI to compare two manifest XML files and get detailed commit/change reports. Install with `pip install diffmanifests`. Configuration lives in a JSON file; all four CLI arguments are required.

## Installation

```bash
pip install diffmanifests
```

Upgrade: `pip install diffmanifests --upgrade`

## Configuration

Configuration is read from a JSON file. **Bundled config** (packed with this skill for OpenClaw hub): use `config.json` in this skill directory. Reference structure:

| Section   | Parameter   | Type    | Description |
|-----------|-------------|---------|-------------|
| **gerrit** | `url`       | string  | Gerrit instance URL |
|           | `user`      | string  | Auth username |
|           | `pass`      | string  | Password or API token |
|           | `query.option` | array | e.g. `["CURRENT_REVISION"]` |
| **gitiles** | `url`     | string  | Gitiles instance URL |
|           | `user`      | string  | Auth username |
|           | `pass`      | string  | Password or API token |
|           | `retry`     | integer | Retry attempts (default: 1) |
|           | `timeout`   | integer | Timeout in seconds (-1 = no timeout) |

Example `config.json`:

```json
{
  "gerrit": {
    "url": "https://android-review.googlesource.com",
    "user": "",
    "pass": "",
    "query": { "option": ["CURRENT_REVISION"] }
  },
  "gitiles": {
    "url": "https://android.googlesource.com",
    "user": "",
    "pass": "",
    "retry": 1,
    "timeout": -1
  }
}
```

## Parameters (CLI)

| Argument            | Required | Description |
|---------------------|----------|-------------|
| `--config-file`     | ✅       | Path to configuration JSON file |
| `--manifest1-file`  | ✅       | Path to first (older) manifest XML |
| `--manifest2-file`  | ✅       | Path to second (newer) manifest XML |
| `--output-file`     | ✅       | Output path; format by extension: `.json`, `.txt`, `.xlsx` |

## Basic usage

Use the bund...