MOADIM(1)

NAME
moadim - routine scheduler with an MCP/REST API and a web control panel

SYNOPSIS
moadim [MODE]
moadim COMMAND [args...]

DESCRIPTION
moadim is a loop engine for AI agents: it runs scheduled routines and exposes them over a REST API, an MCP server, and a web control panel.

Run with no arguments, moadim starts the server in the background and returns control to your shell. Once running, manage it from the web client (the STOP button) or with moadim stop.

MODES

(default)
    Start the server in the background and exit.

-i, --interactive
    Run in the foreground, attached to the terminal (Ctrl-C to stop).

-b, --background
    Start the server detached in the background (the explicit default).

COMMANDS

restart
    Stop a running server (if any) and start a fresh background one.

stop [--json] [-q]
    Stop a running background server. -q / --quiet suppresses the human-readable status line.

status [--json] [--wait[=SECS]]
    Show whether a server is running. --wait polls GET /health until the server answers or SECS elapses (default 30) instead of checking once, so scripts can block on startup instead of sleeping blindly.

cleanup [--json]
    Reap finished, expired routine workbenches now.

trigger <id>
    Trigger a routine to run now, outside its schedule.

install
    Register moadim as an OS service (launchd / systemd user).

uninstall
    Remove the OS service registration and the managed crontab block.

machine <show|set|list>
    Show or set this machine's identity, or list the machines referenced by routines.

help, -h, --help
    Show usage help.

version, -V, --version
    Show the version.

DATA COMMANDS
These talk to the running server over HTTP. Pass --help to any of them (e.g. moadim routines create --help) for the full flag list.

routines <create|list|get|update|replace|delete|trigger|logs|ical> ...
    Manage routines (alias: routine).

schedule trigger <id>
    Trigger a routine by ID (invoked directly from the routine's crontab entry).

agents
    List available agent keys.

OPTIONS

--json
    Pass to stop, status, or cleanup for a single-line, machine-readable object on stdout.

-q, --quiet
    Pass to stop to suppress its human-readable status line.

--wait[=SECS]
    Pass to status to poll for a server to come up (default 30s) instead of checking once.

EXIT STATUS
status , cleanup , and stop exit 0 when a server is running and 3 when none is, so scripts can branch on $? without parsing stdout.

ENVIRONMENT

MOADIM_BIND_ADDR
    Address the server binds to and that client commands target. Defaults to 127.0.0.1:5784. Set it (e.g. 127.0.0.1:8080) before starting the server, and point client commands at the same address.

FILES

~/.config/moadim/
    Configuration tree (routines, agents).

WEB INTERFACE
Once running, the control panel is served at http://127.0.0.1:5784 (or the MOADIM_BIND_ADDR override).

SEE ALSO
Project documentation and the REST/MCP API reference: https://github.com/moadim-io/daemon

AUTHOR
Moadim contributors.