Skip to content

A desktop coding agent with free access to frontier models.

TypeScript
4.1 KB
Raw Blame
---
title: "Get started with OmniRush.ai Cloud"
description: "Connect the desktop app to your organization for Collections, managed connections, models, policies, and hosted workspaces"
---

<Note>
OmniRush.ai Cloud is optional. The local desktop app stays free, requires no Cloud sign-in, and supports your own providers, skills, plugins, and custom MCP servers. Use Cloud when an organization needs to assign and manage those resources for a team.
</Note>

OmniRush.ai Cloud runs on a [self-hosted Den](/start-here/self-host); omnirush.ai does not run a hosted Den. It is for teams that want shared identity, Collections, managed connections and models, desktop policies, or hosted workspaces.

First, create or join an organization and connect the desktop app to it.

<Frame>
  ![OmniRush.ai Cloud org settings with organization identity, allowed email domains, and desktop restrictions](/images/cloud-org-settings.png)
</Frame>

1. Open your Den web origin (for example `https://omnirush.example.com`) in your browser.
2. Click `Create organization`.
3. Enter your org name.
4. Finish checkout if OmniRush.ai Cloud asks for billing.
5. Continue to the desktop sign-in steps below.

Once you're there, you can configure the settings for the organization.

## Configure org settings

<Note>Only the organization owner can change these settings.</Note>

1. Open `/dashboard/org-settings` on your Den web origin.
2. Set the name for your organization.
3. Optional: enable `Restrict allowed email domains` and add the approved domains.
4. Optional: change any `Desktop restrictions` that should apply after people sign in from the desktop app.

These settings apply across the organization. You can also create teams, publish plugins through Collections, configure Connectors and shared models, and deploy hosted workspaces.

Next, you want to make sure you can sign in the desktop app.

## Sign in from the desktop app

1. Open `Settings > Account`.
2. Click `Sign in`.
3. Finish sign-in in your browser.
4. If the browser does not return to OmniRush.ai automatically, click `Paste sign-in code`, paste the `omnirush://den-auth?...` link or one-time code from OmniRush.ai Cloud, then click `Finish sign-in`.

## Cloud URL used by the desktop app

The desktop app uses a single Cloud URL: the Den web `baseUrl`. There is no
hosted default, because omnirush.ai does not run a hosted Den.

All Cloud API and MCP traffic is derived from that one URL through the web app
proxy:

- Cloud API requests go to `<baseUrl>/api/den/v1/...`.
- OmniRush.ai Cloud MCP requests go to `<baseUrl>/api/den/mcp/...`.

The desktop app does not store or read a separate API URL. On startup it reads
the Cloud URL from `desktop-bootstrap.json`; if that file is missing and no
Cloud URL was set through a connect link or `Settings > Advanced`, no Den is
used and Cloud features stay off. When you change the Cloud URL in
`Settings > Account`, OmniRush.ai writes the new `baseUrl` back to the bootstrap
file so the next launch uses the same source of truth.

## Choose your organization

After sign-in, pick your organization in `Settings > Account`. Organization-assigned plugins and skills appear in `Settings > Library`.

## What to do next

- Send members to [Connect your services](/start-here/connect-your-stack/connect-services) to sign in to team-approved accounts from the desktop app.
- Use [Connectors](/cloud/share-with-your-team/shared-mcp-connections) to publish a managed service and grant member or team access.
- Use [Publish and copy a skill](/start-here/do-work-with-it/publish-and-copy-a-skill) for the primary skill-sharing flow, or [Collections](/cloud/share-with-your-team/collections) to group and assign several plugins.
- Use [OmniRush.ai Web](/cloud/run-in-the-cloud/shared-workspace) to give members a hosted OmniRush.ai workspace in the browser, with nothing to install.
- Use [LLM providers](/cloud/share-with-your-team/managed-llm-provider) or [custom LLM providers](/cloud/share-with-your-team/custom-llm-provider) to manage shared model access.
- Use [Members and RBAC](/cloud/members-and-rbac) to invite people, create teams, and control access.