Use this skill when a user needs to install, authenticate, or operate the Just Calendar CLI against https://justcalendar.ai, including generating an agent token in the web UI and performing calendar/day-data management from terminal commands.
Use this skill when a user needs to install, authenticate, or operate the Just Calendar CLI against https://justcalendar.ai, including generating an agent token in the web UI and performing calendar/day-data management from terminal commands.
JustCalendar CLI Skill
Purpose
This skill provides complete operational guidance for justcalendar, a Node.js CLI that manages Just Calendar data in Google Drive through:
Backend-issued Google Drive access tokens from https://justcalendar.ai
Direct Google Drive API reads/writes for calendar data files
Use this skill for setup, login, troubleshooting, and day-to-day CLI operations.
When To Use This Skill
Use this skill when user asks to:
Install or update justcalendar
Login with a token generated in Just Calendar web interface
Add, list, rename, remove, or select calendars
Set/get/delete day values from calendars
Run bulk data operations from terminal
Troubleshoot token/auth/permission errors
Prerequisites
Node.js >=18
npm
Access to https://justcalendar.ai
A Google Drive-connected session in the web app (required to generate token and use Drive-backed operations)
Installation
Global install from npm:
npm install -g justcalendar
justcalendar --help
From local project path:
cd ~/justcalendar-cli
npm install
npm install -g .
justcalendar --help
justcalendar data set"Energy Tracker" 2026-03-01 green
Bulk set (multiple <date> <value> pairs in one call):
justcalendar data set"Energy Tracker" 2026-03-01 green 2026-03-02 yellow 2026-03-03 red
Day Data - Delete
Single delete:
justcalendar data delete "TODOs" 2026-03-01
Bulk delete (multiple dates in one call):
justcalendar data delete "TODOs" 2026-03-01 2026-03-02 2026-03-03
Day Data - Get
Single get:
justcalendar data get "Sleep" 2026-03-01
Bulk get (multiple dates in one call):
justcalendar data get "Sleep" 2026-03-01 2026-03-02 2026-03-03
Bulk-First Rule (Multi-Day Operations)
When handling more than one date, prefer one bulk command over looping per-day commands.
Use these bulk patterns by default:
justcalendar data set <calendar> <date1> <value1> <date2> <value2> ...
justcalendar data delete <calendar> <date1> <date2> ...
justcalendar data get <calendar> <date1> <date2> ...
Use bulk whenever request scope is more than one day, including:
Date ranges
Whole week or whole month operations
Backfills
Batch fixes
Fall back to per-day commands only when:
Bulk command length would exceed shell/OS command length limits
Per-day retries are required for a failed subset
Single-day requests stay unchanged: use the existing single-date command forms.
Bulk Examples
Week update in one data set call:
justcalendar data set"Energy Tracker" \
2026-03-02 green 2026-03-03 yellow 2026-03-04 red \
2026-03-05 green 2026-03-06 green 2026-03-07 yellow 2026-03-08 green