/ 
App-karr-0.500
/ App::karr::Cmd::Sync

NAME

App::karr::Cmd::Sync - Sync karr board with remote

VERSION

version 0.500

SYNOPSIS

karr sync
karr sync --pull
karr sync --push

DESCRIPTION

Synchronises the refs/karr/* namespace with the configured remote. Without flags it fetches the remote ref state and then pushes the local ref state back, pruning deleted refs so destructive restore operations can be mirrored correctly.

OPTIONS

  • --pull

    Only fetches remote refs/karr/*.

  • --push

    Only pushes local refs/karr/* state to the configured remote.

  • --prune

    Accepts a reconciliation that would delete every remaining board ref. Any other command refuses that and stops, because "the remote deliberately dropped the board" and "the remote is empty for the wrong reason" -- a re-created origin, an edited remote URL, a rolled-back hosting-side restore -- look exactly alike from here. Use it to let a karr destroy performed on another clone take effect on this one; check git remote -v first.

  • --accept-foreign-board

    Accepts a pull whose remote presents a different board identity than the one this clone has been syncing with. Any other pull refuses that before reconciling anything, because a swapped remote -- a re-initialised origin, an edited remote URL, a stale clone pointed at the wrong repository -- would otherwise replace this board with a stranger's, silently and totally. Use it when the remote's board really is the one you want from now on; check git remote -v first.

SEE ALSO

karr, App::karr, App::karr::Cmd::Board, App::karr::Cmd::Backup, App::karr::Cmd::Restore

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/karr/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.