/ 
App-karr-0.100
River stage zero No dependents
/ App::karr

NAME

App::karr - Kanban Assignment & Responsibility Registry

VERSION

version 0.100

SYNOPSIS

karr init --name "My Project"
karr create "Fix login bug" --priority high
karr list --status todo,in-progress
karr board
karr set-refs superpowers/spec/1234.md draft ready
karr get-refs superpowers/spec/1234.md

DESCRIPTION

App::karr is the main entry point for the karr command line tool. It manages a Git-native kanban board stored in refs/karr/*. Tasks are kept as Markdown payloads inside Git refs, while commands materialize a temporary board view only for the duration of each operation.

The CLI is designed for local use and for multi-agent workflows backed by Git refs. Commands that mutate board state synchronize through refs/karr/*, so multiple machines or agents can see the same task state without merging task files by hand and without checking a persistent karr/ directory into the repository.

Perl remains the primary local installation path, but Docker is a first-class runtime option when you want to vendor the client into other environments. The default raudssus/karr:latest image starts as root, inspects the ownership of the mounted /work directory, and then runs karr with those numeric credentials so host files do not become root-owned. A companion raudssus/karr:user image stays fixed at build-time KARR_UID/KARR_GID defaults instead. The README covers both flows in detail, including the shell alias pattern.

Besides the board itself, karr can also store helper payloads in arbitrary non-protected refs such as refs/superpowers/spec/.... This is aimed at AI-assisted and agent-style workflows where lightweight shared state is useful without changing the task model.

COMMAND OVERVIEW

  • init, config, context, backup, restore, skill

    Board bootstrap, configuration, context generation, backup and restore, and shipped skill installation.

  • create, list, show, edit, move, delete, archive

    Day-to-day task lifecycle management.

  • board, pick, handoff, destroy, log, sync, agentname

    Board visualisation, multi-agent coordination, activity inspection, Git sync, board teardown, and helper utilities.

  • set-refs, get-refs

    Store and retrieve helper payloads in free-form Git refs outside the protected board namespace.

BOARD DISCOVERY

Most commands automatically search upward from the current directory for a Git repository that contains refs/karr/*. The global --dir option overrides the starting directory used for that repository discovery.

DEFAULT BEHAVIOUR

Running karr without a subcommand shows the board summary, which makes the tool convenient as a quick project status command.

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.