learn-derose

Command-line access to your Learn DeROSE classes and bookings.

Use this CLI if you are a Learn DeROSE student or user who wants to sign in to Learn, see available classes, check your bookings, book a class, join a waitlist, or cancel a booking.

Install on your AI Agent

npx skills add dwaynemac/learn-derose-cli

CLI Quick Start

Run it with npx:

npx --yes learn-derose auth login

Your browser will open so you can sign in to Learn. After that, you can manage your own bookings from the terminal.

If you prefer to install it once:

npm install --global learn-derose
learn-derose auth login

Common Tasks

See available classes:

npx --yes learn-derose classes list --from YYYY-MM-DD --to YYYY-MM-DD

Show only classes that require a booking:

npx --yes learn-derose classes list --requires-booking

Filter classes by teacher:

npx --yes learn-derose classes list --teacher-id 42

See your active bookings:

npx --yes learn-derose bookings list --state active

Book a class:

npx --yes learn-derose bookings create --post-id POST_ID --date YYYY-MM-DD

Use the post_id shown by classes list.

Join the waitlist for a class:

npx --yes learn-derose bookings create --post-id POST_ID --date YYYY-MM-DD --waitlist

Cancel a booking:

npx --yes learn-derose bookings cancel BOOKING_ID

Use the booking id shown by bookings list.

Commands

learn-derose auth login
learn-derose auth status [--json]
learn-derose auth logout [--revoke]

learn-derose classes list [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--account-id ID] [--teacher-id ID] [--presence-type online|in_person] [--requires-booking] [--json]

learn-derose bookings list [--state active|history|all] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--json]
learn-derose bookings show BOOKING_ID [--json]
learn-derose bookings create --post-id POST_ID --date YYYY-MM-DD [--waitlist] [--json]
learn-derose bookings cancel BOOKING_ID [--json]

Use help or --help to see the current command list:

npx --yes learn-derose help

Using With Agents Or Scripts

Add --json when another tool or AI agent needs to read the output:

npx --yes learn-derose bookings list --state active --json

This repo includes an agent skill for booking-management workflows: skills/learn-derose-cli.

Troubleshooting

If a command fails, rerun it with --verbose:

npx --yes learn-derose bookings list --state active --verbose

Verbose logs are written separately from command output and do not print your Learn access tokens or secrets.

Developer setup, OAuth app details, environment variables, and local learn.padma.test troubleshooting live in docs/development.md.