### Install Dependencies and Run Locally Source: https://github.com/aikarjal/wilmai/blob/main/apps/site/README.md Installs project dependencies using pnpm and starts the development server for the wilm-ai/site package. ```bash pnpm install pnpm --filter @wilm-ai/site dev ``` -------------------------------- ### Build and Start Production Server Source: https://github.com/aikarjal/wilmai/blob/main/apps/site/README.md Builds the production-ready site for the wilm-ai/site package and then starts the production server. ```bash pnpm --filter @wilm-ai/site build pnpm --filter @wilm-ai/site start ``` -------------------------------- ### Schedule Examples Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Examples demonstrating how to query the schedule for specific dates, weekdays, or the upcoming days. ```bash # Specific day by date wilma schedule list --date 2026-02-25 --student "Stella" --json ``` ```bash # Next Thursday (also accepts Finnish short forms like to/ke/pe) wilma schedule list --weekday thu --student "Stella" --json ``` ```bash # Tomorrow wilma schedule list --when tomorrow --student "Stella" --json ``` -------------------------------- ### Install Wilma CLI Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Install the Wilma CLI globally using npm. Ensure the user has run the interactive CLI once to create the configuration file. ```bash npm i -g @wilm-ai/wilma-cli ``` -------------------------------- ### Build and Run Wilmai CLI Source: https://github.com/aikarjal/wilmai/blob/main/README.md Install dependencies, build the CLI, and run it from the local project. ```bash pnpm install pnpm --filter @wilm-ai/wilma-cli build node packages/wilma-cli/dist/index.js ``` -------------------------------- ### Install Wilmai as a Skill Source: https://github.com/aikarjal/wilmai/blob/main/README.md Add Wilmai as a skill using npx for integration with AI agents. ```bash npx skills add aikarjal/wilmai ``` -------------------------------- ### Install Wilmai CLI Globally Source: https://github.com/aikarjal/wilmai/blob/main/README.md Install the Wilmai CLI globally using npm or pnpm for system-wide access. ```bash npm i -g @wilm-ai/wilma-cli ``` ```bash pnpm add -g @wilm-ai/wilma-cli ``` -------------------------------- ### Install Wilmai Skills with Skills CLI Source: https://github.com/aikarjal/wilmai/blob/main/skills/README.md Use this command to add the Wilmai skills to your project using the Skills CLI. ```bash npx skills add aikarjal/wilmai ``` -------------------------------- ### Run Wilma CLI live tests Source: https://github.com/aikarjal/wilmai/blob/main/TESTING.md Executes live tests for the CLI package after initial configuration setup. ```bash pnpm --filter @wilm-ai/wilma-cli test:live ``` -------------------------------- ### Wilma Triage Cron Setup Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md Example cron job configuration for the Wilma Triage skill. Run daily at 07:00 as an isolated agent turn job with a 180s timeout. ```cron Schedule: 07:00 daily Timeout: 180s Task: "Read the wilma-triage skill, then run the full triage workflow. Report actionable findings." ``` -------------------------------- ### Wilma CLI MFA Setup (Non-Interactive) Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Pass the TOTP secret directly to the command for one-off MFA authentication. If the TOTP secret is saved, this flag is not needed. ```bash wilma schedule list --totp-secret --student "Stella" --json ``` ```bash wilma schedule list --totp-secret 'otpauth://totp/...' --student "Stella" --json ``` -------------------------------- ### Get Daily Briefing for a Student Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves today's and tomorrow's schedule, upcoming exams, recent homework, and messages for a specific student. Use this as a starting point for parent-facing summaries. ```bash wilma summary --student --json ``` -------------------------------- ### Wilma Triage Output Format Example Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md An example of the brief, actionable output format generated by the Wilma Triage skill. It lists actionable items for each child and calendar updates. ```text 📚 Wilma Update Child A (8th grade) • Math exam tomorrow — yhtälöt, kpl 1-8 • Friday short day (9:20-12:35) — kulttuuripäivä, bring laptop + outdoor clothes • Lesson note (yesterday, MA_8LV): "Sinulta puuttui opiskeluvälineitä" — kirja jäi kotiin Child B (6th grade) • No actionable items 📅 Calendar: Added Child A math exam (Feb 10), removed cancelled disco (Feb 11) ``` -------------------------------- ### Fetch Student Data Summary Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md Use this command as the best starting point to retrieve a comprehensive summary of student data, including schedule, exams, homework, news, and messages. It supports fetching data for all students and outputs in JSON format. ```bash # Best starting point — returns schedule, exams, homework, news, messages wilma summary --all-students --json ``` -------------------------------- ### List Google Calendars Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md Execute this command to list available Google Calendars. You will need to select a calendar ID to store school events. This is part of the first-run setup for calendar synchronization. ```bash gog calendar calendars ``` -------------------------------- ### Get Daily Briefing Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Combine today's and tomorrow's schedule, exams, homework, news, and messages into a single view. Useful for AI agents. ```bash wilma summary [--days 7] [--student ] [--all-students] [--json] ``` -------------------------------- ### Get Daily Briefing for All Students Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves today's and tomorrow's schedule, upcoming exams, recent homework, and messages for all students. This is useful for a comprehensive overview. ```bash wilma summary --all-students --json ``` -------------------------------- ### Read a Specific News Item Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Reads the content of a specific news item by its ID for a given student. Use this to get the full details of an announcement. ```bash wilma news read --student --json ``` -------------------------------- ### Run Wilma client live tests Source: https://github.com/aikarjal/wilmai/blob/main/TESTING.md Executes live tests for the client package after configuring credentials in .env.local. ```bash pnpm --filter @wilm-ai/wilma-client test:live ``` -------------------------------- ### Build wilma-client Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-client/test/README.md Build the wilma-client using pnpm. Ensure you are in the correct project directory. ```bash pnpm --filter @wilmai/wilma-client build ``` -------------------------------- ### Run Live Tests Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-client/test/README.md Execute live tests for the wilma-client using Node.js. Ensure test/.env.local is configured with credentials. ```bash node test/live.spec.mjs ``` -------------------------------- ### Build and run live tests Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/test/README.md Executes the build process for the CLI and runs the live test specification. ```bash pnpm --filter @wilmai/wilma-cli build node test/live.spec.mjs ``` -------------------------------- ### Run wilma-cli Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Execute the CLI tool using either 'wilma' or 'wilmai' command. ```bash wilma ``` ```bash wilmai ``` -------------------------------- ### Fetch Data for All Students Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Demonstrates the use of the `--all-students` flag with various list commands to retrieve data for every student. This is useful for batch processing or school-wide reports. ```bash wilma summary --all-students --json ``` ```bash wilma homework list --all-students --json ``` ```bash wilma exams list --all-students --json ``` -------------------------------- ### List Student Schedule by Date Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Fetches the schedule for a specific student on a given date or day of the week. Accepts 'today', 'tomorrow', 'week', a specific date, or a weekday (e.g., 'thu'). ```bash wilma schedule list --when today --student --json ``` ```bash wilma schedule list --when tomorrow --student --json ``` ```bash wilma schedule list --when week --student --json ``` ```bash wilma schedule list --date 2026-03-10 --student --json ``` ```bash wilma schedule list --weekday thu --student --json ``` -------------------------------- ### Specify Environment File for Live Tests Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-client/test/README.md Run live tests for the wilma-client while specifying a custom environment file path using the WILMA_ENV_PATH variable. ```bash WILMA_ENV_PATH=/path/to/.env node test/live.spec.mjs ``` -------------------------------- ### Run live tests with custom configuration Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/test/README.md Overrides the default configuration path using an environment variable before executing the test. ```bash WILMAI_CONFIG_PATH=/path/to/config.json node test/live.spec.mjs ``` -------------------------------- ### Other Commands Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Utility commands for listing children, updating the CLI, and clearing configuration. ```bash wilma kids list [--json] ``` ```bash wilma update ``` ```bash wilma config clear ``` -------------------------------- ### List Attendance/Lesson Notes Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Show lesson notes for a given date, defaulting to today if no date is specified. ```bash wilma attendance list [--date YYYY-MM-DD] [--student ] [--all-students] [--json] ``` -------------------------------- ### Fetch Data for All Students Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Demonstrates the use of the `--all-students` flag across various commands to fetch data for all students. ```APIDOC ## Fetch Data for All Students ### Description All list commands support `--all-students` to fetch data for all students. ### Usage Examples ```bash wilma summary --all-students --json wilma homework list --all-students --json wilma exams list --all-students --json ``` ### Notes You can also pass a name fragment for `--student` (fuzzy match). ``` -------------------------------- ### List Attendance for All Students Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves per-lesson notes for all students. This command is useful for a school-wide overview of attendance and remarks. ```bash wilma attendance list --all-students --json ``` -------------------------------- ### Clear Configuration Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Removes the local configuration file. ```bash wilma config clear ``` -------------------------------- ### List Attendance and Lesson Notes Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves per-lesson notes, including feedback, remarks, and absence categorizations, for a specific student on a given date. Defaults to today if no date is specified. Prefer specifying `--date ` for morning runs as notes are often added during or after class. ```bash wilma attendance list --student --json ``` ```bash wilma attendance list --date 2026-03-10 --student --json ``` -------------------------------- ### List Messages in a Folder Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Fetches a list of messages from a specified folder (e.g., 'inbox') for a particular student. This is crucial for managing communications. ```bash wilma messages list --student --folder inbox --json ``` -------------------------------- ### List Homework Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Fetch a list of homework assignments, with an optional limit. ```bash wilma homework list [--limit 10] [--student ] [--all-students] [--json] ``` -------------------------------- ### Run Wilma CLI live tests with custom config path Source: https://github.com/aikarjal/wilmai/blob/main/TESTING.md Overrides the default configuration file path when running CLI live tests. ```bash WILMAI_CONFIG_PATH=/path/to/config.json pnpm --filter @wilm-ai/wilma-cli test:live ``` -------------------------------- ### List Exam Grades Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Fetch a list of exam grades, with an optional limit. ```bash wilma grades list [--limit 20] [--student ] [--all-students] [--json] ``` -------------------------------- ### List News and Messages Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Commands to list news items and messages, with options for limiting results and specifying folders. ```bash wilma news list [--limit 20] [--student ] [--all-students] [--json] ``` ```bash wilma news read [--student ] [--json] ``` ```bash wilma messages list [--folder inbox] [--limit 20] [--student ] [--all-students] [--json] ``` ```bash wilma messages read [--student ] [--json] ``` -------------------------------- ### Fetch Lesson Notes (Attendance) Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md Retrieve lesson notes (merkinnät) for attendance. It's recommended to fetch yesterday's notes during a morning run. For a same-day check later in the afternoon, omit the --date flag. Requires specifying a date in YYYY-MM-DD format and outputs in JSON. ```bash # Lesson notes (merkinnät) — fetch yesterday's notes during a morning run, since teachers fill them during/after class. For a same-day check later in the afternoon, omit --date. wilma attendance list --all-students --date --json ``` -------------------------------- ### List Students Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Fetches a list of all students associated with the Wilma account. This is a foundational command for accessing student-specific data. ```bash wilma kids list --json ``` -------------------------------- ### List News Items Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a list of news items for a specific student. This command helps in staying updated with school announcements. ```bash wilma news list --student --json ``` -------------------------------- ### Configure TOTP Secret for MFA Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Provide your TOTP secret for non-interactive MFA login. This is optional if you've saved it interactively. ```bash wilma schedule list --totp-secret --json ``` ```bash wilma schedule list --totp-secret 'otpauth://totp/...' --json ``` -------------------------------- ### Fetch Specific Student Data Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md Drill into specific student data categories as needed. These commands allow fetching detailed lists for exams, schedules, homework, grades, messages, and news for all students, with options for filtering and limiting results. All outputs are in JSON format. ```bash # Drill into specifics as needed wilma exams list --all-students --json wilma schedule list --when today --all-students --json wilma schedule list --when tomorrow --all-students --json wilma homework list --all-students --limit 10 --json wilma grades list --all-students --limit 5 --json wilma messages list --all-students --limit 10 --json wilma news list --all-students --limit 10 --json ``` -------------------------------- ### List Student Homework Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a list of homework assignments for a specific student. This command is essential for tracking academic tasks. ```bash wilma homework list --student --json ``` -------------------------------- ### Schedule Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Fetches the student's schedule for a specified time frame (today, tomorrow, week, specific date, or weekday). ```APIDOC ## Schedule ### Description Retrieves the student's schedule for a specified time frame. ### Usage ```bash wilma schedule list --when today --student --json wilma schedule list --when tomorrow --student --json wilma schedule list --when week --student --json wilma schedule list --date 2026-03-10 --student --json wilma schedule list --weekday thu --student --json ``` ### Notes `--weekday` also accepts Finnish short forms: `ma`, `ti`, `ke`, `to`, `pe`, `la`, `su`. Use `--date` or `--weekday`, not both. ``` -------------------------------- ### List Schedule Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Retrieve schedule information for specific days or the entire week. Supports filtering by date and weekday. ```bash wilma schedule list [--when today|tomorrow|week] [--date YYYY-MM-DD] [--weekday mon|tue|wed|thu|fri|sat|sun] [--student ] [--all-students] [--json] ``` -------------------------------- ### Attendance / Lesson Notes Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Fetches attendance records and lesson notes for a student for a specific day or all students. ```APIDOC ## Attendance / Lesson Notes (merkinnät) ### Description Returns Wilma's per-lesson notes ("merkinnät") for a single day: positive feedback, behavioral remarks, missing materials, and absence categorizations (medical, explained, unexplained). Defaults to today if `--date` is omitted. ### Usage ```bash wilma attendance list --student --json wilma attendance list --date 2026-03-10 --student --json wilma attendance list --all-students --json ``` ### Notes Each note has `start`/`end` times derived from Wilma's hour-grid headers — accurate to the lesson hour, with 45-minute period assumed. `subject` is the Wilma course code (e.g. `MA_8LV` = math, 8th grade), and `typeLabel` is the human-readable Finnish reason or remark. ``` -------------------------------- ### List Exam Grades Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves the grades for exams taken by a specific student. This command provides insight into academic performance. ```bash wilma grades list --student --json ``` -------------------------------- ### Daily Briefing Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a comprehensive summary for a student or all students, including schedule, exams, homework, news, and messages for the current day. ```APIDOC ## Daily Briefing ### Description 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. ### Usage ```bash wilma summary --student --json wilma summary --all-students --json ``` ``` -------------------------------- ### Homework List Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a list of homework assignments for a student. ```APIDOC ## Homework ### Description Retrieves a list of homework assignments for a student. ### Usage ```bash wilma homework list --student --json ``` ``` -------------------------------- ### List Upcoming Exams Source: https://github.com/aikarjal/wilmai/blob/main/packages/wilma-cli/README.md Retrieve a list of upcoming exams, with an optional limit. ```bash wilma exams list [--limit 20] [--student ] [--all-students] [--json] ``` -------------------------------- ### List Students Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a list of all students associated with the account. ```APIDOC ## List Students ### Description Retrieves a list of all students associated with the account. ### Usage ```bash wilma kids list --json ``` ``` -------------------------------- ### Read Full Message or News Content Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma-triage/SKILL.md Read the full content of a specific message or news item when the subject line indicates it requires further attention. Requires the item's ID and the student's name, outputting in JSON format. ```bash # Read full content when subject line looks actionable wilma messages read --student --json wilma news read --student --json ``` -------------------------------- ### News and Messages Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Fetches lists of news items or messages, and allows reading specific items. ```APIDOC ## News and Messages ### Description Fetches lists of news items or messages, and allows reading specific items. ### Usage ```bash wilma news list --student --json wilma news read --student --json wilma messages list --student --folder inbox --json wilma messages read --student --json ``` ``` -------------------------------- ### Non-interactive Wilmai CLI Commands Source: https://github.com/aikarjal/wilmai/blob/main/README.md Execute Wilmai commands in a non-interactive mode, outputting JSON for use by agents or scripts. These commands fetch various data points like summaries, schedules, homework, exams, grades, and attendance. ```bash wilma summary --all-students --json ``` ```bash wilma schedule list --when tomorrow --json ``` ```bash wilma homework list --all-students --json ``` ```bash wilma exams list --all-students --json ``` ```bash wilma grades list --all-students --json ``` ```bash wilma attendance list --all-students --json ``` -------------------------------- ### Read a Specific Message Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Reads the content of a specific message by its ID for a given student. Use this to view the full details of a message. ```bash wilma messages read --student --json ``` -------------------------------- ### Exam Grades Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a list of exam grades for a student. ```APIDOC ## Exam Grades ### Description Retrieves a list of exam grades for a student. ### Usage ```bash wilma grades list --student --json ``` ``` -------------------------------- ### Upcoming Exams Source: https://github.com/aikarjal/wilmai/blob/main/skills/wilma/SKILL.md Retrieves a list of upcoming exams for a student. ```APIDOC ## Upcoming Exams ### Description Retrieves a list of upcoming exams for a student. ### Usage ```bash wilma exams list --student --json ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.