Wilma Skill
Overview
Wilma is the Finnish school information system used by schools and municipalities to share messages, news, exams, schedules, homework, and other student-related updates with parents/guardians.
Use the
/
CLI in non-interactive mode to retrieve Wilma data for AI agents. Prefer
outputs and avoid interactive prompts.
Quick start
Install
bash
npm i -g @wilm-ai/wilma-cli
- Ensure the user has run the interactive CLI once to create
~/.config/wilmai/config.json
- Use non-interactive commands with .
Core tasks
Daily briefing (start here)
bash
wilma summary --student <id|name> --json
wilma summary --all-students --json
Returns today's and tomorrow's schedule, upcoming exams, recent homework, recent news, and recent messages in one call. This is the best starting point for any parent-facing summary.
Schedule
bash
wilma schedule list --when today --student <id|name> --json
wilma schedule list --when tomorrow --student <id|name> --json
wilma schedule list --when week --student <id|name> --json
Homework
bash
wilma homework list --student <id|name> --json
Upcoming exams
bash
wilma exams list --student <id|name> --json
Exam grades
bash
wilma grades list --student <id|name> --json
List students
News and messages
bash
wilma news list --student <id|name> --json
wilma news read <id> --student <id|name> --json
wilma messages list --student <id|name> --folder inbox --json
wilma messages read <id> --student <id|name> --json
Fetch data for all students
All list commands support
:
bash
wilma summary --all-students --json
wilma homework list --all-students --json
wilma exams list --all-students --json
You can also pass a name fragment for
(fuzzy match).
Notes
- If no is provided, the CLI uses the last selected student from
~/.config/wilmai/config.json
$XDG_CONFIG_HOME/wilmai/config.json
- If multiple students exist and no default is set, the CLI will print a helpful error with the list of students.
- When the account has multiple students, is required for read commands.
- If auth expires or the CLI says no saved profile, re-run interactively or use to reset.
- Run to update the CLI to the latest version.
Actionability guidance (for parents)
Wilma contains a mix of urgent items and general info. When summarizing for parents, prioritize actionable items:
Include items that:
- Require action or preparation (forms, replies, permissions, materials to bring).
- Announce a deadline or time-specific requirement.
- Describe a schedule deviation or noteworthy event (trips, themed days, school closures, exams).
- Mention homework, exams, or upcoming deadlines.
De-prioritize items that:
- Are purely informational with no action, deadline, or schedule impact.
- Are generic announcements unrelated to the target period.
When in doubt, include and let the parent decide. Prefer a short, structured summary with dates and IDs.
Scripts
Use
for a stable wrapper around the CLI.
Links