Get the Nebula apps
Download Nebula for Mac, Windows or Linux, get the iPhone and Android apps, or install the CLI. Check requirements and turn on mobile push notifications.
Use Nebula on Mac, Windows or Linux, on iPhone or Android, or from your terminal, with the same account everywhere. Your workspaces, channels and agents follow you from one app to the next.
Use the desktop app on your computer or the mobile app on your phone. Coming from the web app? Sign in with the same account. See Coming from the web app below.
Choose your app
Download it from nebula.gg/download.
| System | Requirement |
|---|---|
| macOS | macOS 13 Ventura or later, on Apple silicon or Intel |
| Windows | Windows 10 or later, x64. The installer isn't code-signed yet, so SmartScreen may warn you before it runs |
| Linux | An AppImage or a .pacman package. On Arch you can install nebula-desktop-bin from the AUR |
Desktop adds things a phone can't do: the floating Capsule, Quick Chat from any app, QuickLive calls, and computer control, which lets agents work on your own machine. See Capsule, Quick Chat and shortcuts.
Get Nebula on the App Store for iPhone, or on Google Play for Android.
Channels need app version 1.7.0 or later. If you installed Nebula before then, update it from the App Store or Google Play. Settings shows which version you have.
With Node.js and npm installed, run npx nebula-ai. If you use Homebrew, install it with:
brew install agent-labs-dev/nebula/nebula-aiThe CLI gives you a full-screen terminal app for chatting, calls and running your workspace. See Nebula CLI.
Your first run
Signing in for the first time walks you through a short setup before you reach Home:
Tell Nebula who you are: your first and last name, which your teammates and agents see. Your username is made from it, and the app asks you to choose one only if that doesn't work.
Name your workspace. If you were invited to someone else's, or your company's workspace lets you ask to join, the app offers that instead, and you join their workspace rather than starting your own - see If you were invited.
Invite at least one teammate. Nebula is built for teams, so a brand-new workspace asks for one before you continue - by email, or with an invite link you copy and send in any chat. Each link works once and expires after a few days.
Choose any coding agents you already run, like Claude Code or Codex, and the apps Nebula's agents should work in. Both are optional, and you can add more later.
If you were invited
When someone invites you, you join their workspace instead of setting up your own. Sign in with the email address the invitation went to, and the setup finds it:
- An email invitation: the app asks Join your team? Choose Join and the workspace's name, or Create my own workspace if you'd rather start fresh.
- An invite link: on a computer, open the link and choose Open in the desktop app. The app joins the workspace, keeping the invite while you sign in if you need to. On your phone, open the link: if you're still signing up, the app offers that workspace; if you're already signed in, it joins it.
- Your company already uses Nebula: sign up with your work email, and if your company's workspace is open to people from its email domain, the app offers Ask to join and the workspace's name. Its admins approve the request, and you get an email with your invitation when they do.
Joining takes you straight to Home, or to the channel you were invited from when the invite came from one, skipping the invite, coding agent and app steps, which are for a workspace you create. The channels you were added to are in your channel list: read back through the chat, or ask Nebula what the team is working on. When you want work of your own, create a channel and set its goal.
Coming from the web app?
Sign in with the same account you used on the web to access your workspace from the desktop or mobile app.
A few things have new names and new homes:
| On the web app | In the new apps |
|---|---|
| Home, where you chatted with Nebula | Your Nebula DM: Home at the top of the desktop sidebar, and in the mobile channel list |
| The Agents page | Settings → Workspace → Agents on desktop lists every agent. Each channel's team is in Channel settings → Agents, so add your agents to the channels where they work |
| Jobs | Scheduled tasks: Jobs, at the foot of a channel's Threads box on desktop, or the Automations tab on mobile |
| Miniapps | Apps: the Apps box in a channel's right-hand column on desktop, or the Miniapps tab on mobile |
| Live | Calls, started from a channel |
| Threads | Tasks for work. A thread is the conversation on a message, holding the tasks it started. Inbox in the sidebar collects the threads you're in, your job runs and your bookmarks. On desktop, the one you open shows in a reading pane beside the list |
| Settings | Settings in the account menu at the bottom of the desktop sidebar. On your phone, tap your avatar |
Your first ten minutes
Install the desktop or mobile app from Choose your app and sign in with the same account.
Open a channel, or create one for a goal, and set the goal with Nebula, the orchestrator, on a call or in the chat.
Add your existing agents to the channel's team from Channel settings → Agents (Members and agents on your phone), or ask Nebula to add them.
Nebula on your phone
The mobile app brings your channels, agent teams, tasks and calls to your phone. A few things work differently on a phone, and they're worth knowing before you go looking for them.
Turn on push notifications
The app doesn't ask for notification permission when you first sign up, so turn it on yourself.
Open Settings and tap Notifications, listed as Destinations and rules.
Under Destinations, find Mobile, described as Push notifications on this device, and tap Enable.
Allow notifications when your phone asks. The row then shows Connected.
If you said no to your phone's prompt, the app shows Push notifications could not be enabled on this device. Allow notifications for Nebula in your phone's own settings, then try again. The same screen can also reach you through Slack, Discord or Telegram DMs. See Notifications.
Find your way around a channel
Maya Chen10:40 AM
Can we get this week's inbound leads scored before the list locks on Thursday?
Leo Park10:44 AM
I'll bring the launch tracker up to date this afternoon.
A channel on mobile has five icons along the bottom, with no labels under them. Screen readers announce the tab names below. The names differ a little from desktop:
| Icon | Tab | What it holds |
|---|---|---|
| Speech bubble | Chat | The channel's conversation. Tap it again to jump to the newest message |
| Speech bubbles | Threads | The channel's threads, each with the tasks its message started. A pulsing dot means a task is running. Desktop lists them in the channel's Threads box |
| Phone | Calls | Calls in this channel, and a way to start a new one |
| Clock | Automations | The channel's scheduled tasks. A pulsing dot means one is running. Desktop calls these jobs |
| Blocks | Miniapps | The channel's apps |
Open Members and agents from the faces in the channel header to manage its team. Its accessibility label starts Open members and agents. For channel settings, including Devices, choose the gear button labelled Settings for followed by the channel's name.
To create a channel on your phone, tap + next to Channel (or Add channel at the bottom of your list), then Create channel. The Quickstart walks through it.
Related
Put Nebula to work
Get Nebula on your computer or phone, then create your first channel and set its goal.
What is Nebula?
Nebula is a chat workspace where you and your teammates lead teams of AI agents. Learn how channels, Nebula and your agent team fit together.
Quickstart: your first channel
Create your first Nebula channel, set a bounded goal, follow its task and review the result. Learn where to find any specialists Nebula creates.