# summary

Import setup-agents workspace state from an export bundle file.

# description

Reads a `.setup-agents-export.json` bundle and appends its records into the current workspace's `.setup-agents/state/` JSONL files.

Validates the bundle format before importing. Existing records with the same id are either skipped or overwritten depending on `--on-conflict`. Use `--dry-run` to preview changes without writing anything.

# flags.file.summary

Path to the export bundle file.

# flags.file.description

Path to a `.setup-agents-export.json` bundle produced by `setup-agents export`.

# flags.on-conflict.summary

How to handle records whose id already exists in the workspace.

# flags.on-conflict.description

Set to `skip` (default) to leave existing records untouched, or `overwrite` to append the incoming record on top of the existing one.

# flags.dry-run.summary

Preview what would be imported without writing any files.

# flags.dry-run.description

Runs validation and conflict resolution but does not write any JSONL records. Useful for auditing a bundle before committing to the import.

# examples

- Import from a bundle file (default: skip conflicts):

  <%= config.bin %> <%= command.id %> --file ./setup-agents-export-1234567890.json

- Import and overwrite conflicting records:

  <%= config.bin %> <%= command.id %> --file ./bundle.setup-agents-export.json --on-conflict overwrite

- Preview import without writing:

  <%= config.bin %> <%= command.id %> --file ./bundle.setup-agents-export.json --dry-run

# info.result

Imported — tasks: %s, decisions: %s, evidence: %s, handoffs: %s, reviews: %s | Skipped — tasks: %s, decisions: %s, evidence: %s, handoffs: %s, reviews: %s

# info.dry-run

Dry run — no files written. tasks: %s, decisions: %s, evidence: %s, handoffs: %s, reviews: %s would be imported.