Summary
Add a new --availability flag to the add command in gcalcli. This flag allows users to explicitly set an event as "Free" or "Busy" during creation.
Why
Currently, gcalcli does not expose the "transparency" (free/busy) field of Google Calendar events. This prevents users from creating "Ghost Blocks" — events that appear on their calendar for planning purposes but do not block their availability for scheduling tools.
Proposed Solution
- Flag:
--availability
- Options:
free, busy (Default: busy)
- Behavior:
free maps to API transparency='transparent'busy maps to API transparency='opaque'
- CLI Standard: Use UI-friendly terms ("availability", "free", "busy") rather than API jargon ("transparency", "opaque"), consistent with other
gcalcli arguments like --title and --where.
Verification
- Users should be able to run
gcalcli add --availability free and see the event as "Free" in the Google Calendar UI.
Related Issues
Summary
Add a new
--availabilityflag to theaddcommand ingcalcli. This flag allows users to explicitly set an event as "Free" or "Busy" during creation.Why
Currently,
gcalclidoes not expose the "transparency" (free/busy) field of Google Calendar events. This prevents users from creating "Ghost Blocks" — events that appear on their calendar for planning purposes but do not block their availability for scheduling tools.Proposed Solution
--availabilityfree,busy(Default:busy)freemaps to APItransparency='transparent'busymaps to APItransparency='opaque'gcalcliarguments like--titleand--where.Verification
gcalcli add --availability freeand see the event as "Free" in the Google Calendar UI.Related Issues