/ 
App-karr-0.500
/ App::karr::Cmd::Create

NAME

App::karr::Cmd::Create - Create a new task

VERSION

version 0.500

SYNOPSIS

karr create "Fix login bug"
karr create --title "Write release notes" --priority high --status todo
karr create --title "Review API" --tags docs,review --body "Check CLI help"
karr create "Ship it" --depends-on 2,3

DESCRIPTION

Creates a new task in the ref-backed board. The new task inherits defaults from the materialized board config and can be seeded with metadata such as priority, class of service, due date, tags, and body text.

OPTIONS

  • --title

    Explicit task title. If omitted, the first positional argument is used.

  • --status, --priority, --class

    Override the configured default lifecycle values for the new task.

  • --assignee, --tags, --due, --estimate

    Populate optional frontmatter fields at creation time.

  • --depends-on

    Comma-separated ids of tasks this one depends on, same shape as --tags. Every id must name a task on this board; an unknown or non-numeric id rejects the create as a usage error before an id is allocated, so nothing is burned (ticket #54). Taking the new card up while a dependency is unfinished warns -- see App::karr::Cmd::Move.

  • --body

    Adds Markdown body text below the YAML frontmatter.

SEE ALSO

karr, App::karr, App::karr::Cmd::List, App::karr::Cmd::Show, App::karr::Cmd::Edit, App::karr::Cmd::Move

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.