NAME

App::karr::Cmd::Handoff - Hand off a task for review

VERSION

version 0.102

SYNOPSIS

karr handoff 7 --claim agent-fox
karr handoff 7 --claim agent-fox --note "Implementation complete" --timestamp
karr handoff 7 --claim agent-fox --block "waiting for QA" --release

DESCRIPTION

Moves a task into review and refreshes its claim so the next stage of work can see who handed it off. The command can append a note, add a blocker, and optionally release the claim after the handoff.

OPTIONS

  • --claim

    Required. Identifies the agent performing the handoff and is validated against the current claim unless that claim has expired.

  • --note, --timestamp

    Append handoff text to the task body, optionally prefixed with the current UTC timestamp.

  • --block, --release

    Record a blocking reason and/or clear the claim immediately after the handoff.

SEE ALSO

karr, App::karr, App::karr::Cmd::Pick, App::karr::Cmd::Move, App::karr::Cmd::Edit, App::karr::Cmd::Log

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-app-karr/issues.

IRC

Join #ai on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de>

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.