User guide

w2m creates a shareable When2Meet poll through a direct request. Poll setup covers the title, dates, hours, and time zone. Participants add their availability on When2Meet.

Creates a public poll

Running w2m new immediately creates a public When2Meet poll.

Start here

Install w2m as an isolated command with uv.
Create a poll with selected dates or an inclusive date range.
Install the Agent Skill so a compatible coding agent can use the command correctly.

Quick example

w2m new "Committee Meeting" \
  --dates 2026-09-28,2026-09-29,2026-10-01 \
  --time 9am-5pm

The command uses your local IANA time zone by default. Supply --timezone to choose another zone. On success, the final line is the public When2Meet URL.

Whole-hour times

When2Meet’s creation form accepts whole-hour boundaries. w2m rejects times such as 9:30am before sending the request.