moodle command reference - unicorn

moodle v0.9.2 — Read Moodle and submit work from the command line.

Global options

These options work on every command; command pages only list the options specific to that command.

Flags	Description
`-V, --version`	Show the version
`--json`	Emit JSON
`--yaml`	Emit YAML
`--table`	Emit a human-readable table
`--fields <fields>`	Select top-level fields
`-o, --output <file>`	Write output to a file
`-v, --verbose`	Enable debug logging
`--no-color`	Disable color output
`-y, --yes`	Confirm mutations non-interactively
`--dry-run`	Print the mutation plan without applying it
`--no-cache`	Bypass session cache reads and writes
`--pretty`	Indent JSON output
`--limit <number>`	Maximum returned rows
`--days <number>`	Deadline window in days
`-h, --help`	Show help

For what each exit code means, see Errors and exit codes.

Core commands

Command	Aliases	Description
`due`	—	Items due in a date window.
`news`	—	Latest announcement threads with first-post text.
`find`	—	Ranked sections, activities and discussion subjects.
`get`	—	Download a resource by id, URL, or UNIT TASK phrase.
`open`	—	Open a unit or activity reference in the browser.
`submit`	—	Upload local files into an assignment; returns the receipt Moodle shows afterwards.
`units`	`courses`	Inspect enrolled units.
`activities`	—	Inspect activities.
`grades`	—	Inspect grades.
`threads`	—	Inspect forum discussion threads.
`forums`	—	Inspect forums.

Additional commands

Command	Aliases	Description
`user`	—	Show authenticated user info.
`todo`	—	List upcoming actionable timeline items.
`alerts`	—	List notifications and message counts.
`overview`	—	Show a compact multi-source overview.
`download`	`dl`	Download one authenticated Moodle file.
`auth`	—	Session and keepalive utilities.
`doctor`	—	Diagnose runtime, browser access, session, background jobs and MCP setup.
`completion`	—	Print shell completion for zsh, bash or fish.
`uninstall`	—	Remove local background jobs; optionally remove the selected Worker and configuration.

Agent commands

Command	Aliases	Description
`mcp`	—	Deploy a private MCP Worker on Cloudflare; encrypted session storage and local renewal. Free-tier limits apply.
`commands`	—	Describe the complete command tree.
`skills`	—	Show skill metadata or delegate to the shared skills CLI.

This page and the pages under moodle/reference are generated from moodle commands --json. Run npm run generate to rebuild them after the CLI changes, and npm run check to confirm the checked-in pages still match the captured command tree.