view release on metacpan or  search on metacpan

bin/karr  view on Meta::CPAN

Export, restore, or remove board state with L<App::karr::Cmd::Backup>,
L<App::karr::Cmd::Restore>, and L<App::karr::Cmd::Destroy>.

=back

=head1 COMMANDS

=head2 Board Setup And Configuration

=over 4

=item * L<App::karr::Cmd::Init>

Creates the initial board in C<refs/karr/*> and can install the bundled
project skill for Claude Code.

=item * L<App::karr::Cmd::Config>

Shows or updates writable board settings such as the board name, defaults, and
claim timeout.

=item * L<App::karr::Cmd::Disable>

Turns off automated agent runs for this board (L<karr-foundation>), optionally
recording a reason. The flag lives in C<refs/karr/config> and syncs with the
board.

=item * L<App::karr::Cmd::Enable>

Turns automated agent runs back on.

=item * L<App::karr::Cmd::Context>

Generates a compact board summary for embedding into files such as F<AGENTS.md>.

=item * L<App::karr::Cmd::Skill>

Installs, checks, updates, or prints the bundled skill file for Claude Code,
Codex, and Cursor.

=back

=head2 Task Lifecycle

=over 4

=item * L<App::karr::Cmd::Create>

Creates a new task card.

=item * L<App::karr::Cmd::List>

Lists tasks with filters for status, priority, tags, claims, and text search.

=item * L<App::karr::Cmd::Show>

Shows the full task document for one task id.

=item * L<App::karr::Cmd::Edit>

Updates task metadata, body text, claims, and blocked state.

=item * L<App::karr::Cmd::Move>

Moves tasks between statuses, including relative moves with C<--next> and
C<--prev>.

=item * L<App::karr::Cmd::Delete>

Deletes task refs permanently.

=item * L<App::karr::Cmd::Archive>

Soft-deletes tasks by moving them to the archived status.

=back

=head2 Board Flow And Coordination

=over 4

=item * L<App::karr::Cmd::Board>

Shows the grouped board view.

=item * L<App::karr::Cmd::Pick>

Finds the next suitable task and claims it for an agent.

=item * L<App::karr::Cmd::Unlock>

Shows the pick locks currently held on the board, and breaks them. The escape
hatch for a lock left behind by an agent that died mid-pick.

=item * L<App::karr::Cmd::Handoff>

Moves work into review and optionally appends a timestamped note.

=item * L<App::karr::Cmd::Log>

Prints activity log entries from C<refs/karr/log/*>.

=item * L<App::karr::Cmd::AgentName>

Generates short random agent names for multi-agent workflows.

=item * L<App::karr::Cmd::Sync>

Explicitly pulls or pushes C<refs/karr/*> when you want to inspect or control
sync separately.

=back

=head2 Snapshot And Recovery

=over 4

=item * L<App::karr::Cmd::Backup>

Exports the entire C<refs/karr/*> namespace as YAML.