/ 
App-karr-0.102
/ App::karr::Cmd::Pick

NAME

App::karr::Cmd::Pick - Atomically find and claim the next available task

VERSION

version 0.102

SYNOPSIS

karr pick --claim agent-fox
karr pick --claim agent-fox --status todo --move in-progress
karr pick --claim agent-fox --tags backend,urgent --json

DESCRIPTION

Selects the next available task for an agent, taking class of service, priority, blocked state, and claim expiry into account. When the board lives in a Git repository, the command also uses lock refs so concurrent agents do not pick the same task.

SELECTION RULES

  • Eligible statuses

    If --status is omitted, tasks in done and archived are excluded.

  • Claim timeout

    Already claimed tasks are ignored unless their claim timestamp has expired according to claim_timeout.

  • Ordering

    Candidates are sorted by class of service, then by priority, then by task id.

  • --move

    Optionally updates the picked task to a new status such as in-progress.

SEE ALSO

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

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.