/ 
App-karr-0.500
/ App::karr::Cmd::Restore

NAME

App::karr::Cmd::Restore - Restore the ref-backed karr board from YAML

VERSION

version 0.500

SYNOPSIS

karr restore --yes < karr-backup.yml
karr restore --yes --input karr-backup.yml

DESCRIPTION

Replaces the complete refs/karr/* namespace with a previously exported YAML snapshot. This is intentionally destructive: refs currently present but absent from the snapshot are deleted as part of the restore.

It is not destructive on the way in, though. Every ref name in the snapshot is checked and every commit object written before the first ref moves, so a snapshot karr cannot apply -- an unusable ref name, or one outside refs/karr/ -- is refused with the board exactly as it was. Nothing is deleted up front, so a restore that fails can no longer leave the board empty.

OPTIONS

  • --input

    Read the YAML snapshot from the given file instead of standard input.

  • --yes

    Required acknowledgement for the destructive restore operation.

SEE ALSO

karr, App::karr, App::karr::Cmd::Backup, App::karr::Cmd::Destroy, App::karr::Cmd::Sync

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.