/ 
App-karr-0.601
/ App::karr::Cmd::Log

NAME

App::karr::Cmd::Log - Show activity log

VERSION

version 0.601

SYNOPSIS

karr log
karr log --agent agent-fox
karr log --task 12 --last 50 --json
karr log --since 2026-01-01 --action move
karr log --compact

DESCRIPTION

Reads activity entries stored in refs/karr/log/* and prints a merged view of recent actions. The command is only available when the board is inside a Git repository because the log lives in Git refs, not in local task files.

The default rendering pads the agent and action into columns so a run of entries reads as a table. --compact drops the padding and prints one space-separated line per entry -- timestamp, agent, action, #id, detail -- which is shorter, survives a long agent name without pushing the rest of the line right, and cuts on whitespace. The detail is omitted entirely when the entry carries none, rather than leaving a trailing space behind.

FILTERS

  • --agent

    Only show entries recorded for a specific agent.

  • --task

    Only show entries associated with a specific task id.

  • --last

    Limit the output to the most recent N entries after sorting by timestamp.

  • --since

    Only show entries timestamped on or after this date (YYYY-MM-DD). The date is validated the way every other date in karr is ("validate_due" in App::karr::Config): calendar-correct YYYY-MM-DD, and a usage error otherwise -- the same rule karr metrics --since follows. The comparison is a string one against the entry's RFC3339 timestamp, so an entry from the --since day itself is kept, matching kanban-md's entry.Timestamp.Before(opts.Since).

  • --action

    Only show entries whose action is KIND. The valid kinds are the actions the board log can actually hold -- archive, create, delete, edit, handoff, move, needs, pick -- taken from "ACTIONS" in App::karr::ActivityLog, the same constant the writers' actions are checked against, so the list cannot drift from what the commands record. An unknown kind is a usage error listing the valid ones, not an empty log.

SEE ALSO

karr, App::karr, App::karr::Cmd::Handoff, App::karr::Cmd::Show, App::karr::Cmd::Board, App::karr::Cmd::AgentName

SUPPORT

Issues

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

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)