@mattbob/skylight-cli

Unofficial CLI for the Skylight family calendar API.

npm install -g @mattbob/skylight-cli
export [email protected]
export SKYLIGHT_PASSWORD=your-password
export SKYLIGHT_FRAME_ID=your_frame_id
# optional:
# export SKYLIGHT_TIMEZONE=Pacific/Auckland
skylight help
skylight events --from today --json

Monorepo usage

From the repo root:

pnpm install
pnpm build
cp .env.example .env   # set SKYLIGHT_* credentials
pnpm skylight help
pnpm skylight events --from today --to friday --json
pnpm skylight chores --assignee Beau --json
pnpm skylight stars --json
pnpm skylight categories --json
pnpm skylight stars award Drew 5 --json

Same via the workspace bin:

pnpm exec skylight events --json
./node_modules/.bin/skylight help

Global link from a clone

Requires pnpm setup once (then restart your shell).

pnpm build
pnpm link --global
skylight help

Remove with pnpm remove --global skylight-calendar.

Global runs only auto-load .env from the current working directory. Outside the repo, export SKYLIGHT_* in your environment.

Prefer --json for machine output. Names resolve exact-first; use --id from categories when ambiguous.

Not affiliated with Skylight. The API is reverse-engineered and may change without notice.