/ 
App-karr-0.600
/ App::karr::Cmd::Move

NAME

App::karr::Cmd::Move - Change a task's status

VERSION

version 0.600

SYNOPSIS

karr move 7 done
karr move 7 --next
karr move 7,8,9 in-progress --claim agent-fox

DESCRIPTION

Moves one or more tasks to a new status. The command understands explicit target statuses and relative movement via --next or --prev, and it enforces require_claim when the destination status requires an owner.

Moving a finished task back into a working column releases the claim the card still carried, unless --claim names the agent taking it up ("apply_status_change" in App::karr::Role::TaskMutation).

Moving a task to the status it already has changes nothing and therefore writes nothing: the card keeps its updated stamp, no activity-log entry is appended, and the command reports Task N is already at STATUS and exits 0 -- the answer karr archive gives for an already-archived card, under the same rule of the exit-code contract. --claim is the exception: a claim handed to the card is a change whether or not the status moves, so karr move ID STATUS --claim NAME takes a card whose claim ran out without needing a detour through another column.

OPTIONS

  • --next, --prev

    Advance or rewind relative to the status order defined in the board config. They are alternatives to a positional target status and to each other, so karr move 7 done --next and karr move 7 --next --prev name two destinations at once and are refused as usage errors (exit 2) before anything is read or written. kanban-md picks a winner silently for both -- the positional over --next, and --next over --prev; karr refuses instead, because the exit-code contract (ADR 0002) can say "you called this wrong" and cobra's all-1 convention cannot.

  • --claim

    Claim the task while moving it. This is commonly used for in-progress or review states.

JSON OUTPUT

Every result object carries changed: true when the card moved, false when it was already at the requested status. A reader that wants to tell the two apart reads that field rather than comparing old_status with new_status, which are both present in either case.

SEE ALSO

karr, App::karr, App::karr::Cmd::Show, App::karr::Cmd::Edit, App::karr::Cmd::Pick, App::karr::Cmd::Handoff

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, licensed under:

The Artistic License 2.0 (GPL Compatible)