NAME
raider-hall - Raider Hall daemon CLI
VERSION
version 0.503
SYNOPSIS
raider-hall init --name bjorn
raider-hall start --daemon --acp-port 38421
raider-hall spawn bjorn "summarise yesterday's git log"
raider-hall ps
raider-hall logs bjorn-1790000000 --follow
raider-hall stopDESCRIPTION
raider-hall runs the subcommands of Langertha::Raider::Hall, the optional daemon that runs raiders on demand, on cron, for Telegram messages and over ACP. It is the same as raider hall: raider-hall start and raider hall start do the same thing.
The hall is the directory holding .raider-hall.yml (see "CONFIG FILE" in Langertha::Raider::Hall); DIR defaults to the current one. raider-hall SUBCOMMAND --help prints the options of a subcommand.
COMMANDS
init [--name NAME] [--engine ENGINE] [--persona PACK]
Write a starter .raider-hall.yml with one raider in the current directory; asks for the name without --name. Never overwrites one.
add-raider NAME [--engine E] [--persona P] [--model M] [--pack X]...
Add a raider entry to .raider-hall.yml. A running hall reads the file once at start, so restart it to use the new entry.
start [DIR] [--daemon] [--acp-port N] [--acp-host H]
Run the hall, in the foreground or with --daemon in the background. --acp-port opens the ACP adapter on TCP port N, over acp: of the config; --acp-host binds it to H (default 127.0.0.1), and only counts together with --acp-port.
stop [DIR]
Send SIGTERM to the running hall.
status [DIR]
The hall's status as JSON.
ps [DIR]
The running raiders: slot, PID, name.
spawn [DIR] NAME MISSION [--attach]
Start raider NAME on MISSION and print its run ID. A name with a leading number (1bjorn) is a singleton slot: a mission for a busy one waits in its queue. --attach then prints the run's event stream as attach does, with the run ID line on stderr; a queued mission has no run yet and is not attached.
attach [DIR] ID
The event stream of the running raider ID: its --stream-json events, one JSON object per line, from the start of the run and as they come, until the raider has exited. For the human-readable output, see logs --follow; for an ended run, logs.
logs [DIR] ID [--follow]
The run's part of its slot log; --follow keeps reading while it runs.
kill [DIR] ID
Stop the running raider ID with SIGTERM.
session reset [DIR] BINDING
Start a new session for a binding (telegram:BOT:CHAT_ID, cron:ID, slot:1NAME, ...); see "session_bindings" in Langertha::Raider::Hall.
install [DIR] [--docker | --host] [--image IMG] [--name NAME] [--acp-port N] [--acp-host H] [--stdout]
Write a systemd user unit that starts the hall, native or through docker run.
ENVIRONMENT
RAIDER_HALL_RAIDER_BIN
The raider executable the hall starts its raiders with. Without it (or when it is not executable), the standalone binary the hall itself runs from, else the raider next to the running script, then the one on PATH. From a standalone binary the hall execs it directly; otherwise it runs it with the perl that runs the hall.
RAIDER_HALL_ACP_PORT
Opens the ACP adapter on this TCP port, over acp: { port: ... } of the config. start --acp-port sets it.
RAIDER_HALL_ACP_HOST
The address the ACP adapter binds to, over acp: { host: ... }; default 127.0.0.1. start --acp-host sets it (together with --acp-port).
The hall sets RAIDER_HALL_SOCKET, RAIDER_HALL_ROOT, RAIDER_HALL_SLOT, RAIDER_HALL_MODE and, for a Telegram mission, RAIDER_HALL_TELEGRAM_BOT, RAIDER_HALL_TELEGRAM_CHAT_ID and RAIDER_HALL_TELEGRAM_THREAD_ID for the raiders it starts; see "ENVIRONMENT" in Langertha::Raider::Hall.
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.