PKR™ Bot — Official Commands Documentation

This page details the commands available in PKR™ (Planning Poker) Bot for Microsoft Teams. You can type these commands in any chat that includes PKRbot. Each command may have optional flags to customize behavior.


@PKR begin

Starts a new planning poker round in the current chat. By default, it uses a 30-second timer and a “points” scale with as many participants as the chat includes.

Usage

@PKR begin [flags...]

Supported Flags

Flag Description
title <text> Sets a title for the round, e.g., title "Onboarding Flow". Default is blank.
time <seconds> Overrides the 30-second timer with your own value, e.g., time 60.
participants/players <N> Manually sets how many participants are expected, if needed.

Example

@PKR begin title "Revamp Website" time 60 players 10

@PKR config

Opens your personal configuration card, where you can set default scale (Points/T-Shirt/Fibonacci), default timer, toggle confidence input, choose anonymous responses, etc.

Usage

@PKR config

No flags are supported for this command.

@PKR help

Displays a help card in the chat with quick start buttons (e.g. “Begin”, “Config”) and a link to more resources.

Usage

@PKR help

No flags are supported for this command.

@PKR history

Searches and displays your past estimation rounds, letting you review final results or re-estimate. If you have a large number of old rounds, you can limit the count or include older (legacy) rounds from a previous version.

Usage

@PKR history [flags...]

Supported Flags

Flag Description
limit <N> Maximum number of rounds to display. Default is 10.
legacy Includes older v1 (pre-May 2025) data from the legacy table, if available.

Example

@PKR history limit 20 legacy

Need additional help? Check out PKRbot Support or contact your system administrator.