Omniscio

Setup Assistant card (post-onboarding guided setup)

The one-time inbox card a brand-new user gets after onboarding, offering a guided setup assistant: what it offers, what launching it opens, and why it is off by default until it ships.

On this page

What it is

When a brand-new user finishes onboarding, Omniscio can leave them one optional inbox card offering a guided tour of setup. It is deliberately one-time and dismissible — an offer, not a gate — and it is the entry point to the Setup Assistant, a conversational walkthrough rather than a wizard.

Accepting it opens a fresh Ask Omniscio session, preloaded with the bundled setup-assistant super prompt. That session is where the guidance actually lives, and the ground it covers is:

  • connecting an AI provider,
  • adding API keys,
  • integrations,
  • automations,
  • agent autonomy,
  • backups.

The bundled prompt behind it is now the first-day welcome guide — the same guide a brand-new user starts from the "Ready for your 5-minute interview?" inbox card as the "Welcome to Omniscio" chat (see first-day-welcome-session.md) — so launching the card opens that guide: an interview about how you use AI, then the setup steps that fit you.

The assistant never sees a raw API key. The card is a launcher; the session it opens talks the user through the provider and key steps without reading the secret itself.

Where to find it

It is not visible yet. The feature is in-development and its setting (onboardingSetupAssistantCardEnabled) defaults to off, so the card does not appear on a normal install. It is revealed through the Lab toggle for the onboarding-setup-assistant-card unreleased feature (or that feature's environment switch), and the toggle also gates the card's appearance for a user who has just completed onboarding.

How it behaves

The card

A one-time inbox card, offered after onboarding completes. It is a normal inbox alert with an action attached, so it carries the usual inbox behaviour — dismiss it and it is gone, and the one-time nature is the point: this is a first-run surface, not a recurring nudge.

The launch

Clicking the action invokes LAUNCH_SETUP_ASSISTANT. The main process — not the renderer — resolves the __ask_amc__ sentinel and reads the bundled super prompt, then creates a fresh Ask Omniscio session carrying it. The request only names the action; it cannot name a prompt or a project, so the card can never be pointed somewhere else.

The spawn is desktop-only, and the bridge enforces it. LAUNCH_SETUP_ASSISTANT sits in the BLOCKED list of the web/mobile WS bridge: a paired phone has no post-onboarding setup card, and must never spawn a desktop Ask Omniscio session over that bridge. The desktop IPC is unaffected — the refusal is scoped to the WS path (src/main/services/web/web-access-ws-channels.ts), and the renderer action degrades gracefully when the call is refused.

Last verified 2026-10-01