/ 
App-karr-0.500
/ App::karr::Cmd::GetRefs

NAME

App::karr::Cmd::GetRefs - Fetch helper payloads from a Git ref

VERSION

version 0.500

SYNOPSIS

karr get-refs superpowers/spec/1234.md
karr get-refs refs/superpowers/spec/1234.md
karr get-refs superpowers/spec/1234.md --dir /path/to/repo

DESCRIPTION

Fetches a single helper ref from the remote and prints only its payload to standard output. Informational messages go to standard error so the command can be composed into scripts or agent pipelines.

A ref that does not exist is a runtime failure: nothing is written to standard output and the command exits 1, so karr get-refs spec.md > spec.md cannot silently truncate its own target. A ref that exists but carries an empty payload is still a success.

--dir names the starting point for Git repository discovery and works both before the command (karr --dir PATH get-refs REF) and after it.

This is especially useful for AI-oriented workflows that want shared spec or planning blobs without coupling them to the task board itself.

SEE ALSO

karr, App::karr, App::karr::Cmd::SetRefs, App::karr::Cmd::Backup, App::karr::Git

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.