/ 
App-Raider-0.001

Changes for version 0.001 - 2026-04-20

  • Initial release.
  • CLI agent (App::Raider) wrapping Langertha::Raider with a default viking persona ("Langertha"), caveman-style communication, and effectively unlimited tool-calling iterations per raid.
  • Tools: filesystem (list_files, read_file, write_file, edit_file), bash (MCP::Server::Run::Bash), web_search and web_fetch (Net::Async::WebSearch + Net::Async::HTTP).
  • Engine auto-detection from available *_API_KEY env var with cheap per-engine default models (claude-haiku-4-5, gpt-4o-mini, etc.).
  • .raider.md for persona customization; hot-reload via /reload; /prompt spawns a sub-agent prompt-builder that writes .raider.md.
  • .raider.yml for engine options (temperature, response_size, ...) with flat or default/<engine> layers; -o key=value CLI override.
  • Skill / profile loading: --claude loads CLAUDE.md and .claude/skills/*/SKILL.md; --openai/--codex loads AGENTS.md; --skills DIR adds plain-markdown dirs. Choices persist to .raider.yml with (saved) banner tag on first use.
  • App::Raider::Skill generates self-describing how-to-use-raider documentation from the live config, as plain markdown or as a Claude Code SKILL.md with YAML frontmatter; usable via CLI (--export-skill / --export-claude-skill) or REPL (/skill, /skill-claude).
  • REPL: Term::ReadLine::Gnu with persistent ~/.raider_history, IO::Prompt::Tiny fallback; plain-ASCII output with blue/green palette; slash commands /help /clear /metrics /stats /reload /prompt /skill /skill-claude /quit.
  • App::Raider::Plugin::Trace streams per-iteration tool calls, args, results and cumulative token counts; meta-line after each raid shows elapsed time, history size vs. context cap, and cumulative tokens in / out / total.
  • App::Raider::Plugin::Situation injects a compact single-line situation block (local time, timezone, host, user) at the start of each session.
  • Auto-compression at 70% of a 40k-token context window to stay under typical per-minute rate limits.
  • Dockerfile with multi-stage build: runtime-root for root use, runtime-user with RAIDER_UID/RAIDER_GID build args for host-uid matching. README includes a shell-alias recipe that mounts $PWD and forwards API-key env vars.

Documentation

raider
Autonomous CLI agent with filesystem and bash access

Modules

App::Raider
Autonomous CLI agent that can browse directories, edit files, and run bash commands
App::Raider::FileTools
MCP::Server factory with local filesystem tools (list/read/write/edit)
App::Raider::Plugin::Situation
Inject situational context (current time, timezone, host, user) at the start of the first raid
App::Raider::Plugin::Trace
Live ANSI-colored progress output for a running Langertha::Raider raid
App::Raider::Skill
Generate a "how to use raider" documentation file from a live App::Raider configuration
App::Raider::WebTools
MCP::Server factory with web search and fetch tools (Net::Async::WebSearch + Net::Async::HTTP)

Other files