# Primary bot

Your primary bot looks out for you. On a schedule you choose it reads what your other bots have been doing and,
if it finds work it could take off your plate, posts a suggestion in its chat. It never starts that
work on its own.

## Choose it

Your first bot is primary at first, and shows a star (★) by its avatar. To pick another:

- Web and desktop: right-click the bot in the sidebar and choose **Make primary**.
- iPhone: touch and hold the bot in the inbox, then choose **Make primary**.
- Android: open the bot's organize sheet and choose **Make primary**.

You have one primary bot at a time. A bot that another bot created can't be primary.

## What a check-in reads

- Your other bots' recent reports, and anything blocked or failed.
- Changed tickets, open to-do items and upcoming [routines](/docs/routines/).
- How you answered its earlier suggestions.
- With a connected app, a read-only look at the next three weeks of your calendar, email and tasks.
- When it looks them up, past [meetings](/docs/meetings/) the primary bot was in.

It reads only your own bots in the space, never another member's. Text copied from those chats is
treated as information, not as instructions.

## What it never does

A check-in can only look and propose. It can't send, change or run anything, and it can't ask you a
question. It posts a few suggestions at most, and when nothing is worth your time it stays silent:
no message, no unread mark, no notification. A check-in that fails shows as failed in
**Activity** at the top of the bot list, also without a notification.

## Suggestions

Each card says what the bot would do, why now, and its plan.

- **Do it** sends "Do it" to the bot as a normal message, so the work runs like any other request
  and [approvals](/docs/approvals/) still apply. If the bot is waiting on a question from you, or is
  already working, "Do it" is handled as if you had typed it there, so it may answer that question.
- **Not now** puts the idea off. The bot sees what you put off and aims differently, and may
  bring the idea back after a few days.
- **Don't suggest this**, in the card's **…** menu, tells the bot the idea was wrong, so it won't
  suggest it again for a month.

Cards you don't answer expire after 7 days, or a day after their due date. To steer what it looks
out for, tell the bot in chat what to watch for or never suggest.

## How often it speaks up

| Level            | Runs                        | Suggestions | Notification |
| ---------------- | --------------------------- | ----------- | ------------ |
| Off              | Never                       | None        | None         |
| Low              | Mondays at 8:00             | 1           | None         |
| Medium (default) | Every day at 8:00           | Up to 3     | Quiet on iPhone, normal elsewhere |
| High             | Every day at 8:00 and 14:00 | Up to 3     | Normal       |

Times are in your timezone (set in **Settings → General**). Open the primary bot's settings and,
under **Advanced → Permissions**, choose a level for **Suggest work**. Only the primary bot has
this setting. Choose Off to stop check-ins; pick a level again and the next check-in is the next
scheduled time.

When a scheduled or other background run of another of your bots fails, the primary bot checks in
about 15 minutes later, on every level except Off. On High, a finished report does the same. These
extra check-ins happen only between 8:00 and 20:00 your time, never once several check-ins have
gone unanswered (turning ideas down counts too), and never past the day's limit, counting the regular ones.

## What it costs

At most 1 check-in runs a day on Low, 2 on Medium and 4 on High, regular and extra together. Each
is skipped, with no model call, when nothing is new since the last one. A message you send the
primary bot counts as new, and on Medium and High with any app connected a check-in runs at least
every 3 days to look ahead. A change on a board alone wakes only High.
Suggestions you leave to expire push the next check-in back a day, up to a week (Low stays
weekly); accepting one resets that. Turning down an idea with **Don't suggest this** also pushes it back a day.
