/ 
App-karr-0.400
/ App::karr::Cmd::Materialize

NAME

App::karr::Cmd::Materialize - Write the ref-backed board out as a tasks/ file view

VERSION

version 0.400

SYNOPSIS

karr materialize
karr materialize --dir path/to/repo
karr materialize --json

DESCRIPTION

Writes the canonical refs/karr/* board out to the repository root as a kanban-md compatible file view: a config.yml plus a tasks/ directory of Markdown cards. The view is disposable and gitignored -- regenerate it whenever you want to grep the board as files or hand it to kanban-md tooling. It is never the source of truth, and writing through it only takes effect via karr import.

The refs are read but never modified, so this command performs no remote sync. Stale tasks/*.md files from a previous materialization are removed before the current tasks are written.

OPTIONS

  • --json

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

SEE ALSO

karr, App::karr, App::karr::Cmd::Import, App::karr::BoardStore, App::karr::Task

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.