/ 
App-karr-0.400
/ App::karr::Cmd::Import

NAME

App::karr::Cmd::Import - Import a tasks/ file view back into the ref-backed board

VERSION

version 0.400

SYNOPSIS

karr import --yes
karr import --yes --dir path/to/repo
karr import --yes --json

DESCRIPTION

Reads the file view at the repository root -- a config.yml plus a tasks/ directory of Markdown cards, as written by karr materialize or by kanban-md tooling -- back into the canonical refs/karr/* board. Original task timestamps are preserved verbatim, so importing an unchanged view is a no-op on the updated field.

This is the destructive inverse of karr materialize: task refs are replaced by the file view, and task refs with no matching file are deleted. It therefore requires an explicit --yes acknowledgement, and, because it mutates refs, it pulls before and pushes after like the other writing commands.

OPTIONS

  • --yes

    Required acknowledgement for the destructive replacement of refs from files.

  • --json

    Print the imported tasks as a JSON array instead of a human-readable summary.

SEE ALSO

karr, App::karr, App::karr::Cmd::Materialize, App::karr::Cmd::Restore, App::karr::BoardStore

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.