@wilm-ai/wilma-cli

Command line interface for Wilma (Finnish school system), built for parents and AI agents.

Install

npm i -g @wilm-ai/wilma-cli
# or
pnpm add -g @wilm-ai/wilma-cli

Run

wilma
# or
wilmai

Commands

Daily briefing

wilma summary [--days 7] [--student <id|name>] [--all-students] [--json]

Combines today's and tomorrow's schedule, upcoming exams, recent homework, news, and messages into one view. Designed for AI agents to surface what matters.

Schedule

wilma schedule list [--when today|tomorrow|week] [--student <id|name>] [--all-students] [--json]

Homework

wilma homework list [--limit 10] [--student <id|name>] [--all-students] [--json]

Upcoming exams

wilma exams list [--limit 20] [--student <id|name>] [--all-students] [--json]

Exam grades

wilma grades list [--limit 20] [--student <id|name>] [--all-students] [--json]

News and messages

wilma news list [--limit 20] [--student <id|name>] [--all-students] [--json]
wilma news read <id> [--student <id|name>] [--json]
wilma messages list [--folder inbox] [--limit 20] [--student <id|name>] [--all-students] [--json]
wilma messages read <id> [--student <id|name>] [--json]

Other

wilma kids list [--json]
wilma update
wilma config clear

Config

Local config is stored in ~/.config/wilmai/config.json (or $XDG_CONFIG_HOME/wilmai/config.json). Use wilma config clear to remove it. Override with WILMAI_CONFIG_PATH.

Notes

• Credentials are stored with lightweight obfuscation for convenience.
• For multi-child accounts, you can pass --student <id|name> or --all-students.
• All list commands support --json for agent-friendly structured output.