/ 
App-karr-0.402
/ App::karr::Cmd::Disable

NAME

App::karr::Cmd::Disable - Disable automated agent runs on this board

VERSION

version 0.402

SYNOPSIS

karr disable
karr disable --reason "abandoned driver, backlog parked"
karr disable --json

DESCRIPTION

Turns the board-level agent switch off. The flag is board state, not machine state: it is written to refs/karr/config as foundation.enabled (with the optional foundation.reason) and pushed with the rest of the board, so every karr-foundation instance on every machine sees it.

A disabled board is skipped by App::karr::Foundation whole: no drain, no auto-block, no agent run. The flag is checked before the agent command is even resolved, so it wins over karr-foundation --command, the config's default_command, the per-repo .karr command, and claude: true. --force does not override it — disabled means disabled.

Nothing else changes: the board stays fully usable for humans and for agents driven by hand (karr list, karr pick, karr move, …). Use it for a repository whose backlog is parked rather than abandoned, so an automation host that drains every discovered board leaves this one alone.

The same state is readable and writable through App::karr::Cmd::Config (karr config get foundation.enabled, karr config set foundation.enabled false); there is one truth in the board config, and this command is the ergonomic front door to it.

OPTIONS

  • --reason TEXT

    Free-text note stored as foundation.reason and shown by karr-foundation --status. Omitting it clears any previously stored reason.

  • --json

    Emit the resulting state as JSON instead of text.

SEE ALSO

karr, App::karr, App::karr::Cmd::Enable, App::karr::Cmd::Config, App::karr::Foundation

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; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.