> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parsaa.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Orbit Overview

> The console and Apple SDK that show what your shipped app does on real devices

## What Orbit is

Parsaa Orbit is the other half of Parsaa. The macOS app works on the code in front of you. Orbit works on the app you already shipped: crashes from real devices, MetricKit vitals, sessions and screens, test runs, build logs, App Store state, product analytics, and pull request reviews.

It has two parts:

<CardGroup cols={2}>
  <Card title="The console" icon="chart-line" href="/orbit/console">
    A web console at [platform.parsaa.app](https://platform.parsaa.app), one project at a time, with a page per surface.
  </Card>

  <Card title="The Apple SDK" icon="apple" href="/orbit/sdk-installation">
    A Swift package with no dependencies. Add it to your app and it reports what Apple already knows about it.
  </Card>
</CardGroup>

Nothing in Orbit is a second account. It signs in with the Parsaa account you already have, and it spends the same credits.

## One login, one ledger

Your Parsaa account owns identity, your plan and your credit balance. Orbit verifies that account and never mints a login of its own, and it never keeps a second balance: the Usage page reads the Parsaa ledger and shows you what Orbit debited from it.

That has one practical consequence worth knowing up front. **Ingestion is free. AI is what costs credits.**

<Info>
  Uploading a crash report, a build log, an `.xcresult`, an Instruments `.trace` or a compliance scan never debits a credit. Neither does reading anything in the console, or letting the SDK send telemetry. Only an AI action you ask for spends, and it prices itself before it runs.
</Info>

Every AI action follows the same four steps: the page estimates the cost on render, running one opens a confirm step naming the cost and your balance, nothing is charged until you confirm, and the result lands with the model and the credits it used printed under it. A run that fails, or that the model refuses, is not charged.

## Tiers and what each unlocks

Your workspace tier decides which surfaces answer and how far back they read. It comes from your Parsaa plan.

|                                           | Free                | Pro                     | Pro+           | Ultra          |
| ----------------------------------------- | ------------------- | ----------------------- | -------------- | -------------- |
| Monthly credits                           | 150 once, at signup | 1,400                   | 3,800          | 9,200          |
| Projects                                  | 1                   | 3                       | Unlimited      | Unlimited      |
| Seats                                     | 1                   | 1                       | 3              | 10             |
| Continuous SDK ingest                     | No                  | Yes                     | Yes            | Yes            |
| Diagnose: Crashes, Telemetry, Performance | Yes                 | Yes                     | Yes            | Yes            |
| Ship: Tests, Build, Release, Compliance   | No                  | No                      | Yes            | Yes            |
| AI actions and pull request reviews       | No                  | Yes, 20 reviews a month | Yes, uncapped  | Yes, uncapped  |
| Analytics: Overview and Versions          | Yes                 | Yes                     | Yes            | Yes            |
| Analytics: People and Behaviour           | No                  | Yes                     | Yes            | Yes            |
| Analytics: Revenue, Reports, App Store    | No                  | No                      | Yes            | Yes            |
| Analytics window                          | 30 days             | 90 days                 | 13 months      | 13 months      |
| Evidence retention                        | 30 days             | 60 days                 | 90 days        | 90 days        |
| Ingest rate per SDK key                   | 60 a minute         | 600 a minute            | 2,000 a minute | 6,000 a minute |

<Note>
  **Free is the demo, and the demo does not run the model.** A Free workspace can read every surface it has and upload evidence by hand, but `POST /v1/ingest/*` is answered `402` for its SDK key, so an app cannot stream telemetry into it. The 150 signup credits belong to the Parsaa app's chat, not to Orbit's AI actions.
</Note>

## Free versus paid, in one line each

* **Free forever, on every tier**: uploading and storing evidence, every read in the console, Insights, the Analytics tabs your plan carries, syncing agent runs and screen maps from the Parsaa app, and the whole telemetry pipeline.
* **Costs credits, always with an estimate first**: a pull request review, a crash diagnosis, an Instruments trace analysis, a store review theming, an AI memory merge, and Ask analytics.

## What Orbit never does

Orbit is read only outward. It never writes to App Store Connect, never writes to your app, and the one thing that ever writes to your repository is **Apply suggestion** on a review finding, which a person clicks. Everything else it writes is its own state: a crash group's status, an alert rule, a project setting, a review decision posted back as a GitHub check run or a comment.

## Where to start

<Steps>
  <Step title="Create a project">
    Sign in at [platform.parsaa.app](https://platform.parsaa.app) with your Parsaa account and create a project for the app.
  </Step>

  <Step title="Add the SDK">
    Add the Swift package and start it with the project's SDK key. See [SDK installation](/orbit/sdk-installation).
  </Step>

  <Step title="Choose what it may collect">
    Settings, Telemetry is the capture policy: eight surfaces, each with a switch and a share of sessions. See [Capture policy](/orbit/capture-policy).
  </Step>

  <Step title="Wire the CLI into CI">
    `orbit upload` sends `.xcresult` bundles, build logs, dSYMs and traces. See [The orbit CLI](/orbit/cli).
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="What the SDK collects" icon="list-check" href="/orbit/what-the-sdk-collects">
    What is automatic, what your app has to call, and what never leaves the device.
  </Card>

  <Card title="The console" icon="browser" href="/orbit/console">
    A paragraph per page, from Overview to Settings.
  </Card>

  <Card title="Analytics" icon="chart-mixed" href="/orbit/analytics">
    Identities, lifecycle states, revenue and the weekly digest.
  </Card>

  <Card title="MCP and agents" icon="robot" href="/orbit/mcp-and-agents">
    Connect Claude Code, Cursor or Codex to a project.
  </Card>
</CardGroup>