moodle-cli 0.1.0b0

Terminal-first CLI for Moodle LMS

moodle-cli

Terminal-first CLI for Moodle LMS that reuses an authenticated browser session.

Repository: https://github.com/bunizao/moodle-cli

Features

• No API token setup required
• Reads MoodleSession from your browser or MOODLE_SESSION
• Works with Moodle AJAX APIs and falls back to authenticated page scraping when needed
• Terminal output plus --json and --yaml

Requirements

• Python 3.10+
• uv
• An active Moodle browser session, or a MOODLE_SESSION environment variable

Install

uv sync

Usage

uv run moodle --help
uv run moodle user
uv run moodle courses
uv run moodle activities 34637

Configuration

On first run, the CLI will ask for your Moodle base URL and save it to config.yaml.

Safety checks during setup:

• Requires a full root URL such as https://school.example.edu
• Rejects paths, query strings, and fragments
• Probes the site before saving
• Requires explicit confirmation if the target does not look like Moodle

If you prefer to configure it manually, create config.yaml in the project directory or in ~/.config/moodle-cli/:

base_url: https://school.example.edu

You can copy from config.example.yaml.

Environment overrides:

• MOODLE_BASE_URL
• MOODLE_SESSION

Development

uv run python -m compileall moodle_cli
uv build

CI

GitHub Actions runs the following checks on pushes and pull requests:

• Dependency lock sync with uv
• Bytecode compilation
• CLI smoke check
• Package build