/ 
App-karr-0.600
/ App::karr::Cmd::Init

NAME

App::karr::Cmd::Init - Initialize a new karr board

VERSION

version 0.600

SYNOPSIS

karr init --name "My Project"
karr init --statuses backlog,todo,in-progress,review,done
karr init --name "Client Work" --claude-skill
karr init --new-board          # in a clone whose remote already has one

DESCRIPTION

Creates a new board inside refs/karr/* in the current Git repository. The command writes the initial config and metadata refs and can optionally install the bundled Claude Code skill into the repository.

Before it writes anything it asks the remote whether this repository already has a board there, because git clone does not fetch refs/karr/* and a fresh clone is therefore indistinguishable from a repository that never had one. A remote that advertises refs/karr/* means the board exists and is one karr sync away, so init refuses and says so rather than starting a second board beside it (#182). Every other answer -- no remote, an unreachable one, no answer inside the probe's budget -- lets init through: it has to work offline.

OPTIONS

  • --name

    Sets the board name stored in board.name.

  • --statuses

    Replaces the default status list with the comma-separated statuses you supply.

  • --new-board

    Starts a board here even though the remote already has one, skipping the question init otherwise asks it. For the rare case where a clone deliberately keeps its own, independent board -- and, because it takes no round trip at all, for initializing without touching the network. The two boards do not sync with each other: the board-identity guard refuses that, which is what it is for (#95).

  • --claude-skill

    Copies the bundled skill file to .claude/skills/kanban-issues-karr-cli/SKILL.md -- the same file App::karr::Cmd::Skill installs for the claude-code agent, and written the same way: in place, keeping the inode of a SKILL.md that is already there, so one that is a link of a hardlink chain shared across projects stays part of that chain.

SEE ALSO

karr, App::karr, App::karr::Cmd::Config, App::karr::Cmd::Create, App::karr::Cmd::Skill

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)