# summary

Sync workspace state to or from a shared remote target for team visibility.

# description

Pushes or pulls .setup-agents/state/ JSONL files to a GitHub Gist.
Run without --pull to push. Run with --pull to merge remote state into local.

# examples

- Push state to a new private Gist:

  <%= config.bin %> <%= command.id %> --remote gist

- Push to existing Gist:

  <%= config.bin %> <%= command.id %> --remote gist:abc123

- Pull from Gist:

  <%= config.bin %> <%= command.id %> --remote gist:abc123 --pull

# flags.remote.summary

Remote target. Use 'gist' to create a new private GitHub Gist, or 'gist:<id>' to use existing.

# flags.pull.summary

Pull and merge remote state into local instead of pushing.

# flags.dry-run.summary

Print what would be pushed or pulled without modifying state.

# info.pushed

Pushed %s files to %s

# info.pulled

Pulled %s records from %s (%s conflicts skipped)

# info.dryRun

[dry-run] Would push: %s

# warn.noState

No state files found in .setup-agents/state/. Nothing to push.