# Installation


# Requirements

`w2m` requires Python 3.11 or later. Install `uv` with its [official installation guide](https://docs.astral.sh/uv/getting-started/installation/).


# Install the command

Clone the repository:

``` bash
git clone https://github.com/sdhutchins/when2meet-cli.git
cd when2meet-cli
```

Install `w2m` in an isolated environment managed by `uv`:

``` bash
uv tool install .
```

Verify that the command is available:

``` bash
w2m --help
w2m new --help
```

The help output begins with:

``` text
Usage: w2m [OPTIONS] COMMAND [ARGS]...
```

If `uv` reports that its tool directory is absent from `PATH`, run `uv tool update-shell` and open a new terminal.


# Install for development

Use editable mode when changing the source code:

``` bash
uv tool install --editable . --force
```

An installation created with `--editable` stays connected to the repository location. Standard installation mode keeps the command available after the repository moves or is deleted.


# Remove the command

``` bash
uv tool uninstall when2meet-cli
```