p202 sync

Sync entities from one profile to another

Writessupports --staged
All commands

p202 CLI reference

Back to the docs

01Run it

Replace the <placeholders> with your own values, or use the builder below.

p202 sync <entity|all>

02What you get

Pick the shape you need. People get a table. Add --json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats

03Build your command

Pick values and the command line writes itself, quoted and ready to paste.

p202 sync

Set flags below; the command updates as you type.

04Flags

7 flags, plus the global flags every command takes.

FlagWhat it does
--dry-runboolShow sync actions without writing
--force-updateboolUpdate mismatched target records
--fromstringSource profile name (alias: --source)
--skip-errorsboolContinue processing after record-level failures; exits 5 when any record failed, and a 401 or 403 still stops it
--sourcestringSource profile name (alias of --from)
--targetstringTarget profile name (alias of --to)
--tostringTarget profile name (alias: --target)

05Commands

2 under p202 sync.

p202 sync historyShow sync history between profilesp202 sync statusShow sync status and drift summary between profiles

06For agents

Running this from an agent

  • Read the same facts as JSON: p202 commands sync --json.
  • With AI_AGENT, CLAUDECODE or another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with a hint.
  • Exit codes: 0 ok, 1 bad input, 2 auth, 3 network, 4 server error, 5 partial failure.
  • This command writes. Add --staged to record it as a proposal a person applies with p202 change apply.
p202 commands sync --json
{
  "path": "p202 sync",
  "use": "sync <entity|all>",
  "short": "Sync entities from one profile to another",
  "runnable": true,
  "flags": [
    {
      "name": "dry-run",
      "type": "bool",
      "default": "false",
      "usage": "Show sync actions without writing",
      "required": false
    },
    {
      "name": "force-update",
      "type": "bool",
      "default": "false",
      "usage": "Update mismatched target records",
      "required": false
    },
    {
      "name": "from",
      "type": "string",
      "default": "",
      "usage": "Source profile name (alias: --source)",
      "required": false
    },
    {
      "name": "skip-errors",
      "type": "bool",
      "default": "false",
      "usage": "Continue processing after record-level failures; exits 5 when any record failed, and a 401 or 403 still stops it",
      "required": false
    },
    {
      "name": "source",
      "type": "string",
      "default": "",
      "usage": "Source profile name (alias of --from)",
      "required": false
    },
    {
      "name": "target",
      "type": "string",
      "default": "",
      "usage": "Target profile name (alias of --to)",
      "required": false
    },
    {
      "name": "to",
      "type": "string",
      "default": "",
      "usage": "Target profile name (alias: --target)",
      "required": false
    }
  ]
}