Skip to main content
This guide gets you from a fresh install to a working Studio setup as quickly as possible. Follow the steps in order.

What you will have at the end

  • the desktop app installed and running
  • one agent configured and assigned to an issue
  • Home and Inbox open and populated
  • a clear path through the daily user loop

Step 1 — Install

Download the macOS app, install it, and confirm it opens. The app bundles its own local service. There is nothing else to install or start separately.

Step 2 — Run onboarding

Onboarding is where you describe the first initiative, choose the first runtime, and create the first agent and issue. It runs automatically on first launch. Do not skip any of the three steps — each one sets context the rest of the product depends on.

Step 3 — Orient in the sidebar

Sidebar explains how the app is structured. Read it once so navigation feels predictable. The four pages you use most - Home, Inbox, Issues, Agents - are all in the main sidebar or reachable from the top identity mark.

Step 4 — Open Home

Home is the user-level read on Studio. After onboarding, open it and confirm the context, first agent, and first issue are visible. Check in this order:
  1. Context
  2. Agent roster
  3. Live motion
  4. Asks for you
  5. Throughput line

Step 5 — Open Inbox

Inbox is where you work through what needs attention. After agents start running, Inbox is where failures, approvals, and alerts surface. Open the Pending tab first. It shows unresolved items in the order they need action.

The daily user loop

Once the initial setup is done, you operate a repeating loop:
  1. Open Home - read the current state of the system
  2. Open Inbox - clear approvals, review failures, address alerts
  3. Open Issues - check which issues are blocked or unassigned
  4. Open Agents - inspect any agent with a failure or stale scheduled run
  5. Intervene when needed - retry runs, reassign issues, approve or reject requests
This loop takes minutes when the system is healthy and longer when something needs attention.

Where to go next

  • Agents — create more agents or inspect the first one in detail
  • Issues — create more work and assign it
  • Projects and Initiatives — organize work above the issue level
  • Settings — inspect scheduled run state and local runtime controls