/ 
App-karr-0.600
/ App::karr::Cmd::SetRefs

NAME

App::karr::Cmd::SetRefs - Store helper payloads in a Git ref

VERSION

version 0.600

SYNOPSIS

karr set-refs superpowers/spec/1234.md draft ready
karr set-refs refs/superpowers/spec/1234.md "full payload"
karr set-refs superpowers/spec/1234.md < design.md
karr set-refs superpowers/spec/1234.md "payload" --dir /path/to/repo

DESCRIPTION

Writes a helper payload into a free-form Git ref outside the protected board namespace. This is intended for adjunct workflow data such as AI planning artifacts or coordination hints that should sync through Git without becoming a task card.

The payload is every argument after REF, joined with a single space. That is a one-line shape on purpose, and it is the whole payload: a multi-line document handed over as several arguments would come back as one long line. So a document is piped instead -- with no CONTENT argument at all the payload is read from standard input verbatim, newlines and all, and karr set-refs REF < file round-trips through karr get-refs REF > file. Stdin is only read when there is nothing to join, so an argument form that worked before is untouched, and a bare karr set-refs REF at a terminal is still the usage error it always was rather than a command that sits there waiting.

Like the rest of the Perl CLI, this works fine from a local install, and the same command can be run from the Docker wrapper if you prefer the vendored runtime style described in the README.

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

SEE ALSO

karr, App::karr, App::karr::Cmd::GetRefs, 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, licensed under:

The Artistic License 2.0 (GPL Compatible)