/ 
App-karr-0.500
/ App::karr::Cmd::Edit

NAME

App::karr::Cmd::Edit - Modify an existing task

VERSION

version 0.500

SYNOPSIS

karr edit 5 --title "Updated title"
karr edit 5 --add-tag urgent --remove-tag stale
karr edit 5 --add-depends-on 2,3 --remove-depends-on 4
karr edit 5 -a "Waiting for review"
karr edit 5 --claim agent-fox --block "waiting on API"

DESCRIPTION

Updates one or more existing tasks in place. Use it to adjust metadata, append notes, manage tags, claim or release ownership, and mark tasks as blocked or unblocked without changing the task id.

COMMON OPERATIONS

  • Metadata updates

    --title, --status, --priority, --assignee, and --due replace existing values. --status is the same status change App::karr::Cmd::Move performs and obeys the same rules, require_claim included.

  • Claim ownership

    Editing a task claimed by another agent is refused unless that claim has expired. --claim with the current claimant's name proceeds, and --release is exempt, since breaking a stale claim is what it is for.

  • Body updates

    --body replaces the entire body; -a/--append-body appends a new line to the existing body text.

  • Claims and blocking

    --claim refreshes claim ownership and timestamp, --release clears the claim, --block records a blocking reason, and --unblock removes it.

  • Tag management

    --add-tag and --remove-tag accept comma-separated lists.

  • Dependency management

    --add-depends-on and --remove-depends-on accept comma-separated task ids and follow the tag rule: add appends without duplicating, remove is a no-op for ids the card does not carry. Ids being added must exist on this board and must not name the task itself; an unknown or non-numeric id rejects the whole invocation as a usage error before anything is written, while a self-reference fails only the id it is wrong for and lets the rest of the batch proceed. Removing an id the board no longer has stays legal -- it is how a dependency on a deleted task is cleaned up.

SEE ALSO

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

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.