NAME

raider - Autonomous CLI agent with filesystem and bash access

VERSION

version 0.003

SYNOPSIS

raider "Find all TODO comments in lib/ and summarize them"
raider -e openai -m gpt-4o "Run the test suite and fix any trivial failures"
raider -i -r ~/dev/myproject
raider --json "Summarize README.md" > result.json

DESCRIPTION

raider is the CLI front-end for App::Raider. It wires an LLM engine (via Langertha) to a filesystem tool server and MCP::Run::Bash, then runs the Langertha::Raider multi-turn agent loop on your prompt.

Interactive mode (-i) opens a REPL with conversation history retained across turns. With Term::ReadLine::Gnu installed, line editing and persistent input history (~/.raider_history) are enabled automatically — including across Ctrl-C interrupts. Slash commands available in the REPL: /help, /clear, /metrics, /stats, /reload, /prompt, /skill, /skill-claude, /model, /quit.

With --json, raider emits a single JSON object ({response, metrics, elapsed}) instead of the human-oriented output, which is useful for scripting.

API keys come from standard environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.).

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-app-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.