WorkDesk · Setup
WorkDesk

Your working surface, set up in ten minutes.

WorkDesk turns an Obsidian vault into an agent-guided working surface: transcripts become notes and action items, and everything links back to its source. Two tiers, both on this page. Starter is the small one you can adopt alone in an evening. WorkDesk OS is the full six-zone system. Install whichever you were sent here for.

About 10 minutes macOS Needs Obsidian + Claude Code
Tier one · Starter

WorkDesk Starter

The small tier. Drop a meeting transcript in a folder and Claude turns it into a meeting note, people notes, and your action items. No accounts, no API keys. Four steps, about ten minutes. Quit Obsidian before step 2 if it's already open. Code on GitHub.

01

Install the two apps

Skip anything you already have.

  1. Obsidian: download, install, open it once, then quit it.
  2. Claude Code: follow the install instructions, then open Terminal, type claude, and sign in when it asks.
02

Install the folder system

Make sure Obsidian is closed. Open the Terminal app, paste this in, then press return. It builds a fresh vault at ~/WorkDesk/ and won't touch any Obsidian vaults you already have.

$ curl -fsSL https://raw.githubusercontent.com/BenaliHQ/workdesk-starter/main/init.sh | bash
03

Open the vault and add the WorkDesk plugin

Open Obsidian, switch to the new WorkDesk vault (vault switcher, bottom-left corner), then add the plugin through BRAT:

  1. If Obsidian asks about community plugins, choose Turn on community plugins.
  2. Open Settings (the gear, bottom-left) and scroll the left sidebar down to BRAT.
  3. Click Add Beta plugin.
  4. Paste the repository below into the box, then click Add Plugin. It installs and turns itself on.
BenaliHQ/workdesk-operating-system
04

Start your first session

Back in Terminal, open the vault with Claude Code:

$ cd ~/WorkDesk && claude

Then type this and press return:

  1. /welcome: a guided ten-minute setup that ends with a sample meeting already processed, so you see the whole thing work before touching your own data.

That's it. From here on: drop transcripts in intake/, check gtd/inbox/ for your action items, and use /daily for a short morning read on where things stand.

WorkDesk OS: watch the setup walkthrough first

2:02 · a quick screen recording of the whole thing
→
Tier two · full system

WorkDesk OS

The full five-zone system with skills, signals, and integrations. Three steps, about ten minutes, no admin password or Homebrew. You still need Obsidian and Claude Code installed first (step 1 above).

01

Install the configuration

Open the Terminal app and paste this in, then press return. It builds a fresh vault at ~/Workdesk-OS/ and won't touch any Obsidian vaults you already have.

$ curl -fsSL https://raw.githubusercontent.com/BenaliHQ/workdesk-configuration/main/init.sh | bash
02

Open the vault and add the WorkDesk plugin

Open Obsidian, switch to the new Workdesk-OS vault (vault switcher, bottom-left corner), then add the plugin through BRAT:

  1. If Obsidian asks about community plugins, choose Turn on community plugins.
  2. Open Settings (the gear, bottom-left) and scroll the left sidebar down to BRAT.
  3. Click Add Beta plugin.
  4. Paste the repository below into the box, then click Add Plugin. It installs and turns itself on.
BenaliHQ/workdesk-operating-system
03

Start your first session

Back in Terminal, open the vault with Claude Code:

$ cd ~/Workdesk-OS && claude

Then type these two, one at a time — press return after each and follow along:

  1. /workdesk-doctor — a quick health check that everything installed cleanly.
  2. /onboarding — a calm, ~10-minute guided setup that captures your role and gets you rolling.

That's it. You'll land in a fresh WorkDesk with the full surface, ready for your own work.

The field guide

Start using Workdesk.

Get to know the six zones, then follow the workflows for planning your day, running a project and processing a meeting. The full guide includes a searchable skill directory and folder reference.

Good to know

A few reassurances

It won't touch your existing vaults

Each installer creates a brand-new vault (~/WorkDesk/ for Starter, ~/Workdesk-OS/ for OS). Anything you already keep in Obsidian stays exactly as it is.

Your notes stay yours

Plain Markdown files in a folder on your Mac. No accounts to create, no API keys to paste, nothing sent anywhere except through Claude Code. The vault keeps working without us.

No admin password, no Homebrew

The install is macOS-native. It doesn't ask for your password, install Homebrew, or need developer tools.

Want to see it first?

Put WORKDESK_DRYRUN=1 in front of the Starter install command, or WORKDESK_INIT_DRYRUN=1 in front of the OS one, to preview exactly what it will do. No files written.

One command away

Ready when you are.

If anything looks off during setup, email khalil@benali.com and you'll be un-stuck in a minute. Nothing here is fragile.

WorkDesk · Mac-only · a Benali system