NAME

App::karr::Cmd::Board - Show board summary

VERSION

version 0.302

SYNOPSIS

karr board
karr board --tags
karr board --compact
karr board --json

DESCRIPTION

Renders a board-oriented summary grouped by status. The default output is a compact, Markdown-flavoured plaintext board: the board name as an # heading, each status as a ## section, and one - id | title | meta... line per task. This stays readable when piped, redirected, diffed, or pasted. Colour is added only when standard output is a terminal (and NO_COLOR is unset). Compact and JSON modes remain available for automation and scripting.

OUTPUT MODES

  • Default output

    Lists every status as a ## Status section (in board order, empty sections included; an empty archived is hidden). Each task renders as - id | title followed by priority (non-default only), @claimant, blocked:reason, and due:date tokens where applicable. A footer line totals tasks, claims, and blocks.

  • --tags

    Adds an extra indented line of #tag tokens beneath each task that has tags.

  • --compact

    Prints one line per status in the form status(count): ids.

  • --json

    Emits the board name, total task count, and a structured columns array with per-status task lists.

SEE ALSO

karr, App::karr, App::karr::Cmd::List, App::karr::Cmd::Show, App::karr::Cmd::Pick, App::karr::Cmd::Context

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.