# Pomodoro command reference

Start, pause and manage focus and break sessions in Discord.

HTML reference: https://www.productivity-bot.com/docs/pomodoro/

A question mark after an option means it is optional.

## /pomodoro start

Start a focus or break session.

```text
/pomodoro start mode? duration? voice_channel? autojoin? visibility?
```

### Options

- `mode` (Optional): The Pomodoro session mode, such as focus or break.
- `duration` (Optional): The length of the Pomodoro session.
- `voice_channel` (Optional): The Discord voice channel the bot should use for Pomodoro audio playback.
- `autojoin` (Optional): Controls whether the bot should automatically join the selected voice channel.
- `visibility` (Optional): Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

## /pomodoro active

Show the currently active Pomodoro session.

```text
/pomodoro active visibility?
```

### Options

- `visibility` (Optional): Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

## /pomodoro pause

Pause the current Pomodoro session.

```text
/pomodoro pause visibility?
```

### Options

- `visibility` (Optional): Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

## /pomodoro resume

Resume a paused Pomodoro session.

```text
/pomodoro resume visibility?
```

### Options

- `visibility` (Optional): Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

## /pomodoro extend

Add more time to the active session.

```text
/pomodoro extend minutes? visibility?
```

### Options

- `minutes` (Optional): The number of minutes to add to the active Pomodoro session.
- `visibility` (Optional): Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

## /pomodoro stop

Stop the active Pomodoro session.

```text
/pomodoro stop visibility?
```

### Options

- `visibility` (Optional): Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.