# 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.

> **Warning: Creates a public poll**
>
> Running `w2m new` immediately creates a public When2Meet poll.


# Start here

- [Install w2m](installation.md) as an isolated command with `uv`.
- [Create a poll](creating-polls.md) with selected dates or an inclusive date range.
- [Install the Agent Skill](agent-skill.md) so a compatible coding agent can use the command correctly.


# Quick example

``` bash
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.