/ 
Langertha-Raider-0.503
/ Langertha::Raider::CLI

NAME

Langertha::Raider::CLI - Autonomous CLI agent that can browse directories, edit files, and run bash commands

VERSION

version 0.503

SYNOPSIS

use Langertha::Raider::CLI;

my $app = Langertha::Raider::CLI->new(
    # engine/model/api_key auto-detected from *_API_KEY env vars
    root           => '/path/to/project',
    skill_sources  => [
        { type => 'file',   path => 'CLAUDE.md' },
        { type => 'claude', path => '.claude/skills' },
    ],
    engine_options => { temperature => 0.2 },
);

my $result = $app->run('Explore the repo and summarize it.');
print $result;

DESCRIPTION

Langertha::Raider::CLI wraps Langertha::Raider with a standard toolbox for a working coding/system agent:

It is the command line's Langertha::Raider::Application: all the attributes and methods documented there (root, engine_name, model, mission, packs, raid_f, run, explain_config, ...) apply here, and this class adds what belongs to the terminal -- the live "trace", the per-tool agent profiles of --claude / --openai and "token_stats". The command line itself is raider.

default_model_for_engine

my $model = Langertha::Raider::CLI::default_model_for_engine('openai');   # 'gpt-4o-mini'

A plain function, not a method: the model an engine uses when no model is set ("model" in Langertha::Raider::Application) -- raider's cheap default for the engine, else the engine class's own default, undef for an engine that needs an explicit model (openrouter) or an unknown one.

trace

Emit live ANSI-colored progress output (iteration markers, tool calls, tool results) via Langertha::Raider::Plugin::Trace. Defaults to on when STDOUT is a terminal.

trace_out

Filehandle the "trace" is printed to. Defaults to STDOUT.

source_labels

The command-line flags that set what "explain_config" in Langertha::Raider::Application and the other reports name ("source_label" in Langertha::Raider::Application): -e, -m, -k, -o, --pack, --perl, --bare, -M, ...

persona_intro

The default persona's opening names the CLI.

persona_turn_end

The CLI loops back to the user.

ignored_agent_files

Returns a list of per-tool agent files that exist in the working root but are NOT covered by the current "skill_sources" in Langertha::Raider::Application. Intended to power the banner's "seeing AGENTS.md, ignoring" notice.

trace_plugin

Returns the loaded Langertha::Raider::Plugin::Trace instance, or undef if trace is disabled.

token_stats

Cumulative token counts for this session (hashref with prompt, completion, total, calls) — available when trace is enabled, nothing otherwise.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha-raider/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 <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.