Skip to main content
The Chief of Staff is the assistant every workspace comes with. It works like a coworker, with skills, knowledge, routines and apps of its own, and it reaches further than one: it works on the whole workspace, builds coworkers, briefs them, follows their runs and answers your questions about Rerun itself.
The code and the API call the Chief of Staff the foreman. Same thing.

Where you meet it

During onboarding

The Chief of Staff is the first thing you talk to. Once you have told Rerun your website, your line of work and your role, it speaks first: what it understood of your company, and a starter team for your kind of business. See Quickstart for the whole path. While it reads your website, it also fills the Brain, the pages every coworker reads about your company. It runs on your workspace’s machine from its first words. If you switch to another tab meanwhile and allowed notifications, your browser tells you when it answers.
On a self-hosted install there is no trial step. Without OPENROUTER_API_KEY, there are no onboarding questions either, and the Chief of Staff runs on the AI you connect. See Configuration.

On the board

Once your team is built, the Chief of Staff waits in a corner of the board as an orb. On a wide screen it sits in a pill that reads Ask your Chief of Staff, or Ask followed by its name once it has one.
  • Click the orb or the pill to open its chat.
  • Drag the orb to another corner to move it there.
  • Press ⌘ K (Ctrl K on Windows and Linux) to type to it straight away. Inside a coworker panel or the Brain, that shortcut keeps its own meaning.
  • Hold Space to talk to it, and release to send, when no field has the focus and nothing is open over the board.
When it needs you while its chat is closed, the orb shows a card: Needs your answer or Needs your approval, with Answer or Review to open it and Later to put it aside. In the Classic view of the workspace, the Chief of Staff sits at the top of the list of coworkers, under the line Ask anything. Click it and its chat takes the middle, laid out like a coworker’s: General and the threads you opened as tabs, + for a new one beside them, and the speech bubble button at the end of the bar for every conversation. On your phone, see iPhone app.

In the control center

Press ⌘ F (Ctrl F on Windows and Linux) to open the Control center: jump to a coworker, a setting or a conversation, or type a question and pick Ask your Chief of Staff. Press the shortcut again to close it.

Its name

The Chief of Staff can carry a name of your choosing. Early in a conversation it offers to take one, once per conversation: say the name and it keeps it. A workspace admin can also click its name on its card and type another one, or empty the field to give it back the name Chief of Staff. A name holds 1 to 24 letters, digits, spaces, dots, apostrophes or hyphens. It is the workspace’s, not one member’s: every member reads it in the list of coworkers, on its chat and its card, in the control center and the keyboard shortcuts. Only an admin renames it, in the chat or on the card.

Its chat

The chat opens as a column beside the board. From the Move menu of its header, pick Dock left, Dock right or Float, and drag its edge to resize it. It has two tabs: In the Classic view the chat has no tabs: the card sits in the column on the right, under the Chief of Staff’s name. Open it by clicking the orb at the start of the chat’s bar, as you click a coworker to open its card, and it stays open as you go from one to the other. Click a routine to open its coworker on it.
On a workspace whose machine has not updated yet, the second tab still reads Routines and only lists the scheduled tasks of the workspace.

Its card

The card opens the screens a coworker’s card opens, on what the Chief of Staff keeps of its own: Every member of the workspace reads those screens. Changing its apps, skills, knowledge and routines takes a workspace admin. As with a coworker, any member adds, edits and deletes its files, and starts one of its routines with Run now. Its skills and its knowledge belong to the workspace, not to one member: what it learns in your conversation, it knows in a teammate’s. Like a coworker, it proposes to keep a way of working as a skill: a row above the field of its chat, with Remember to write the skill and No. Deciding takes a workspace admin. See Skills. A routine or a webhook trigger of its own runs with nobody in front of it, so it works there like a coworker (files, web, its apps, its database, the coworkers it can call) and creates or changes nothing in the workspace. Its routines are listed with the coworkers’ in the list under the card, under the name Chief of Staff: click one to open it on the card’s Routines screen. Each run of one of its routines or webhooks opens a thread in General, named after it, for the member who follows the Chief of Staff, which whoever scheduled the routine does, in its chat or on its card. When several members follow it, the thread goes to the one who joined the workspace first, and to the founder of the workspace when nobody follows it. A run sends no inbox notification and no email of its own: only what the Chief of Staff flags for you does, see below. When the next step is obvious, its answer ends on up to three short replies under the message: click one and it is sent as your own message, word for word. A reply that still needs something from you (a link, a name) is put in the field for you to finish instead.

Check-ins

The Chief of Staff also wakes up on its own to look at your workspace: a check-in. During a check-in it only reads (your coworkers, their runs, its memory, the Brain, the shared files and the shared database) and decides whether something deserves your time. It creates, changes, sends and deletes nothing, and runs no command. When it has nothing to say, nobody hears about it. When it has something to say, it opens a thread in your General, named after what it found, and sends a notification to your phone if you have the iPhone app. The thread reads Needs you until you open it. Its message says what it saw and the one next step it suggests, with buttons under it: click one, or answer in your own words, and the work happens there, in the conversation, with you. It writes to the member a finding is about, when that member sees every Box of the workspace, and to the owner of the workspace otherwise: the thread carries everything the check-in read. It sends nothing to a member who muted the Chief of Staff or asked for no notification at all, and it does not bring up again what a recent check-in already told someone while nothing about it changed. When it tells you it will come back to something, it sets itself a routine that wakes it in a check-in at that time, listed with its other routines. Those routines wake it at most three times a day, one check-in at a time: one that comes due while another runs waits for it. Otherwise it takes a look at the workspace once a day, during the day where the person who started the workspace lives (between 9:00 and 18:00 for them): Never two of these daily looks within 20 hours. A check-in you start yourself, or one it promised, does not count. Check-ins are on for every workspace. A workspace admin opens them from the Chief of Staff’s card: the Check-ins row says when it next looks, and opens a screen of their own: A check-in runs on the model picked in the Chief of Staff’s chat, like everything else it does. On a self-hosted server whose operator turned them off, the switch reads Switched off on this server.

General and threads

Your main conversation is General. Click New conversation to open a thread: it starts as New conversation until you write in it, and Back to General takes you back. The clock button, Conversations, lists General and every thread. A thread that waits on your answer or your approval shows Needs you on its line in General. Click the line to answer it right there, the way you answer a coworker’s thread from its General (see Human in the loop), or Open conversation to go to the thread. Each member of the workspace has their own conversations with the Chief of Staff. It acts with your own rights: a member who cannot manage a Box cannot have it change that Box either. See Teams and workspaces.

Its model

After onboarding, you pick the Chief of Staff’s model from its pill like for any coworker. See Configure a coworker.

What it can do for you

Ask in plain words. The Chief of Staff does the work itself, then puts a row under its answer for each coworker it touched: click the row to open that coworker on the right tab. It answers questions about Rerun from this documentation rather than from memory, so what you read here is what it tells you.

What it does not do

  • It changes nothing inside the settings panels it opens: you set those yourself. The exception is the model a coworker runs on, which it can set.
  • It cannot be rewritten, duplicated or deleted, and it publishes no page. Only its name changes, see Its name.
  • It takes no paid app: those connect to a coworker.
  • It never asks for a secret in the chat: a key goes through its form.

Getting started

New workspaces get a Getting started checklist in the bottom-left corner of the board. It shows how many steps are done, and appears once the Chief of Staff has taken over from the onboarding. Click a step to get it done: the phone opens your account, the payment method opens the card form, the AI subscription and the invitation open their settings panel, and the other steps send a request to the Chief of Staff, who walks you through. Until the list is done or hidden, the Chief of Staff also offers its next step in its chat, one at a time, once it has answered what you asked. Click Hide to put the list away, and bring it back from Getting started in the Help menu.

The reward

During the free trial, completing every step adds 3 days to your trial: Get 3 more free trial days turns into 3 days added to your trial. The days are only added to a trial that is still running. See Plans and billing.
On a self-hosted install there is no phone step, no payment method step and no trial to extend: the checklist has the four other steps.