Browse documentation
Getting started

Quickstart

Connect a Shopify store and get your first audit back. Five steps, no configuration files, no code.

This gets you from a cold account to an AI team reading your real store data. Nothing here requires code.

1. Create an account

Sign in at /auth. Authentication is a six-digit code sent by email: there is no password to choose and no magic link to click. The code is the only sign-in path.

2. Create an organisation

An organisation owns stores, billing and members. Everything else hangs off it:

  • Stores belong to an organisation, never to a user.
  • Credits are pooled per organisation, not per seat.
  • Members carry a role: owner, admin, member or viewer.

3. Connect a Shopify store

Two paths, and which one you take decides what the AI may touch:

| Path | What it is | When | |---|---|---| | OAuth app | The standard Shopify install flow. Scopes are approved on Shopify's own consent screen. | Most stores. | | Custom App | You mint an Admin API token in your Shopify admin and paste it. | When you need scopes the public app does not request. |

The scopes you approve are a hard ceiling. No agent, tool or autonomy level can reach past them: if the AI never got read_orders, no amount of autonomy makes order data readable.

4. Let the audit run

On connection, the platform reads the catalogue, the theme, the content pages and whatever analytics your scopes allow. The first pass produces findings, not changes, regardless of your autonomy level.

5. Ask

The chat is the interface. Address the orchestrator directly:

@Atlas audit my product titles for SEO and tell me the three
worst offenders.

Or address a specialist by name when you already know who owns the question — @Maya for marketing, @Marco for merchandising. The roster is in The AI team.

What it costs

Every model call is metered against your credit balance. Two guardrails sit in front of it, and both are hard:

  • A request whose estimated cost exceeds your balance is refused with 402 before a single token streams.
  • A request that reaches your balance mid-stream is aborted, not allowed to overrun.

Details in Credits & metering.

Next

  • Autonomy levels — decide how much the AI may do on its own.
  • Systems — the capabilities you can turn on per store.
  • Wiring an external client instead? Start at API overview.

Built on these docs?

Drop into the forum if something's unclear or wrong. Docs improve faster when readers flag the gaps.

Open the forum