Setup guide

Set up your Chief of Staff.

Choose the instructions for your computer. Mac uses a guided local agent task; Windows uses one local PowerShell command.

Before you start on Mac

  • A Mac with Claude Code or Codex installed and ready to run a local task.
  • Your license key from Gumroad email or your Gumroad Library. It looks like COS-XXXX-XXXX.
  • Permission to use awair.me and write a chief-of-staff folder on your Desktop.
Mac

Guided setup with Codex or Claude Code

Your local agent handles the download, creates the Desktop folder, and continues directly into onboarding.

1

Start a fresh local task

Claude Code

Open the Claude app, click Claude Code, and start a fresh local task. You do not need to create the destination folder first.

Codex

Open Codex and start a fresh local task from the home screen. You do not need to choose a project.

2

Paste one setup instruction

The same instruction works in both agents.

Set up my Chief of Staff on this computer. Follow the instructions at https://awair.me/setup. Create a chief-of-staff folder on my Desktop after asking permission, ask for my Gumroad license key when needed, and complete onboarding with one starter workflow.
3

Approve local setup

The agent asks before making a temporary download or writing the Desktop folder. Approve both when prompted.

If chief-of-staff contains unrelated files, the agent uses the next available name, such as chief-of-staff-2.

4

Enter your key and answer the setup questions

Paste the key from your Gumroad email or Library only when the agent asks. It uses the key for the download and does not save it in the workspace.

It asks how you work, what matters, what it should own first, what format you like, and what it should never do without asking.

  • email
  • news
  • travel
  • tasks
  • custom
5

Connect only what that workflow needs

Gmail is optional. Setup asks you to connect Gmail only if you choose the email workflow. News, travel, tasks, and custom workflows do not require Gmail.

6

Run your first workflow

After setup, open the Desktop chief-of-staff folder in Claude Code or Codex. Then use the command setup gives you.

  • triage email
  • news brief
  • travel plan
  • tasks review
  • create custom flow

If something is off

Open the Chief of Staff folder in a local agent task and paste this. It checks the workspace without overwriting your profile, preferences, projects, rules, or memory.

Check my Chief of Staff setup using https://awair.me/setup. Preserve all of my existing files and preferences.
You stay in control. Chief of Staff asks before sending, booking, paying, inviting anyone, or changing external systems.

Need a license key?

Get Chief of Staff self-serve, then come back here when you are ready to install it.