view release on metacpan or  search on metacpan

.claude/skills/karr-foundation-cli/SKILL.md  view on Meta::CPAN

---
name: kanban-issues-karr-foundation-cli
description: Use when managing karr-foundation — periodic agent execution across multiple karr boards, drain loops, and auto-block logic.
---

# karr-foundation — Periodic Agent Executor for karr Boards

Single-shot daemon that monitors multiple karr boards and runs an agent command
when work is available. Designed for cron/systemd-timer invocation.

## Quick start

```bash
# Config at ~/.config/karr-foundation/config.yml
dirs:
  - /storage/raid/home/getty/dev/perl/dbio-dev/dbio
  - /storage/raid/home/getty/dev/perl/dbio-dev/dbio-postgresql
scan:
  - /storage/raid/home/getty/dev/perl/dbio-dev   # finds dirs with .karr file

bin/karr-foundation  view on Meta::CPAN

    # One-shot run forcing execution in all repos
    karr-foundation --force

    # Preview without executing
    karr-foundation --dry-run --verbose

=head1 DESCRIPTION

F<karr-foundation> reads a config file listing karr board directories, detects
board changes or open tasks, and invokes a configured agent command for each
active repo. It is designed to be called repeatedly — by cron, a systemd timer,
or a tight while-loop.

See L<App::karr::Foundation> for full documentation.

=head1 SUPPORT

=head2 Issues

Please report bugs and feature requests on GitHub at
L<https://github.com/Getty/karr/issues>.

lib/App/karr/Foundation.pm  view on Meta::CPAN

    # Preview what would run
    karr-foundation --dry-run --verbose

    # Read-only overview of every board (no agent runs)
    karr-foundation --status

=head1 DESCRIPTION

F<karr-foundation> is a single-shot, idempotent CLI meant to be invoked
periodically (cron, systemd-timer, while-loop). It scans configured karr
boards, detects changes or open work, and B<drains> each board by invoking the
configured agent command repeatedly until no actionable task remains.

B<Config file:> C<~/.config/karr-foundation/config.yml> (or C<--config>).

  dirs:
    - /path/to/repo1
    - /path/to/repo2

  scan: