view release on metacpan or  search on metacpan

bin/karr  view on Meta::CPAN

Git-native kanban board whose canonical state lives in C<refs/karr/*>, plus
optional helper payloads in non-protected refs outside that namespace.

Run it from inside a Git repository. Commands discover the repository root,
pull the current board refs, materialize a temporary board view for the command
run, and then write changes back to Git refs. In normal use this means you can
interact with shared task state without checking a persistent F<karr/>
directory into the work tree.

The script is the best starting point when you want to understand the CLI as a
user. For architecture notes, Docker background, and Perl-facing examples, see
L<App::karr>.

=head1 CLI WORKFLOW

A typical session looks like this:

=over 4

=item 1.

docs/superpowers/specs/2026-03-19-v0004-release-design.md  view on Meta::CPAN

5. **Log append + read** — append entries from two "agents", verify merged output is sorted
6. **`from_string`/`from_file` parity** — same content parsed both ways produces identical Task objects
7. **`is_repo` from subdirectory** — verify detection works from `karr/` inside a git repo
8. **Config sync** — `next_id` collision prevention across two agents

Existing tests (`t/01-task.t` through `t/07-context.t`) must continue to pass unchanged.

## Out of Scope (v0.005+)

- `metrics` command (throughput, cycle time)
- `sync --watch` (background daemon polling)
- Dependency checking (block tasks with unsatisfied deps)
- Self-healing IDs
- WIP limit enforcement on move
- TUI (Tickit)
- External repo refs (`refs/karr/external/`)
- Messages in task metadata