view release on metacpan or  search on metacpan

bin/karr  view on Meta::CPAN

L<App::karr::Cmd::List>, L<App::karr::Cmd::Show>, and
L<App::karr::Cmd::Board>.

=item 3.

Progress work with L<App::karr::Cmd::Move>, L<App::karr::Cmd::Edit>,
L<App::karr::Cmd::Pick>, and L<App::karr::Cmd::Handoff>.

=item 4.

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::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::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.

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

Replaces the current board refs from a YAML snapshot. This is intentionally
destructive and requires explicit confirmation flags.