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

# Merging Evidence Packs

> Combine several kane-cli evidence packs into a single sealed pack with kane-cli evidence merge, including the strict default policy and collision handling.

***

<Note>
  **Using Claude Code, Cursor, or another coding agent?** Paste this into your prompt to run cross-browser and real-device tests, debug sessions, and wire up CI on the TestMu AI cloud:

  ```
  Read https://www.testmuai.com/support/docs/SKILL.md to set up TestMu AI (formerly LambdaTest) cloud testing.
  ```
</Note>

`kane-cli evidence merge` combines several packs into one, for example the packs from a set of related runs you want to hand over as a single file:

```bash theme={null}
kane-cli evidence merge <targets...> --run-id nightly-2026-07-11
```

Targets are execution ids or pack paths, and **order matters**. Earlier targets win where the policy has to choose.

| Flag                      | Description                                                                                           | Default                                |
| ------------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------- |
| `--run-id <id>`           | Run id for the merged pack, **required**                                                              | —                                      |
| `-o, --out <path>`        | Output path                                                                                           | `.testmuai/evidence/<run-id>.evidence` |
| `--rules <path>`          | Custom merge-rules file. Settings you omit keep their default value; the rule list itself is replaced | built-in defaults                      |
| `--on-collision <action>` | `error`, `prefer-first`, `prefer-latest`, or `discard`                                                | `error`                                |
| `--title <title>`         | Title for the merged run                                                                              | first eligible pack's                  |
| `--no-finalize`           | Keep the merged pack live instead of sealing it                                                       | seals by default                       |
| `--json`                  | Machine-readable merge report                                                                         | off                                    |
| `--env <name>`            | Environment (`prod` or `stage`)                                                                       | active env                             |

`--rules` and `--on-collision` are mutually exclusive.

Exit codes: `0` merged, `1` policy abort, `2` usage error.

## The default policy

Out of the box, merge is strict:

* inputs must be **sealed and valid**,
* duplicate run ids are skipped,
* packs from **different projects or organisations** are refused,
* a test-id collision is an **error**, unless you choose another action with `--on-collision`.

## A nightly roll-up

```bash theme={null}
kane-cli evidence merge \
  .testmuai/evidence/*.evidence \
  --run-id nightly-2026-07-11 \
  --title "Nightly regression"
```

With no `-o`, the merged pack is written to `.testmuai/evidence/<run-id>.evidence`, which stays unique as long as the run id does.

The result is one sealed pack holding the tests from every pack that passed the policy. Packs the policy skipped contribute nothing, and the merge report (`--json`) lists what was skipped and why.

## Next steps

* [Validating packs](/docs/docs/kane-cli-evidence-validate/) — confirm the merged pack before handing it over.
* [Viewing evidence](/docs/docs/kane-cli-evidence-viewing/) — open the merged pack.