# Nebula Documentation

> Nebula is an AI agent platform. Build agents, connect 1,000+ apps, and automate workflows through natural conversation.

Full documentation in a single file: [llms-full.txt](https://docs.nebula.gg/llms-full.txt)

Individual pages as markdown: append `.mdx` to any docs URL (e.g. `/docs/getting-started/quickstart.mdx`)

## Getting Started

- [What is Nebula?](https://docs.nebula.gg/docs/getting-started.mdx): Nebula is a workspace where you and your team work with AI agents — research, code, posting to Slack, automations, all through natural conversation.
- [Quickstart](https://docs.nebula.gg/docs/getting-started/quickstart.mdx): Sign up for Nebula, meet your workspace, and create your first AI agent, channel, or miniapp — all in under five minutes, no setup required.
- [Sharing & access](https://docs.nebula.gg/docs/getting-started/sharing-and-access.mdx): Share agents, jobs, and miniapps with your workspace and control who can view or edit each one — plus how a shared agent runs on its owner's connections.
- [Your first agent](https://docs.nebula.gg/docs/getting-started/first-agent.mdx): Create your first Nebula agent — a focused AI worker for one job. A five-step wizard covers identity, description, tools, access, and review.
- [Your first channel](https://docs.nebula.gg/docs/getting-started/first-channel.mdx): Create your first channel in Nebula. Channels are workspace-scoped rooms where threads, agents, and teammates collaborate on a topic.
- [Your first miniapp](https://docs.nebula.gg/docs/getting-started/first-miniapp.mdx): Create your first Nebula miniapp — a dashboard, form, or picker — by describing what you want. Nebula builds and deploys it for you.
- [What Nebula Can Do](https://docs.nebula.gg/docs/getting-started/what-nebula-can-do.mdx): See everything Nebula can do — web research, code execution, app integrations, automations, media generation, and more. Plus what it can't do yet.

## Home

- [Home and getting around Nebula](https://docs.nebula.gg/docs/home.mdx): Home is your launcher — ask for anything from one box. The sidebar holds every destination, and each thing you open stays put as a tab.
- [Search your workspace](https://docs.nebula.gg/docs/home/search.mdx): Find any conversation, message, agent, job, miniapp, or file across your Nebula workspace — and run common actions — from one keyboard palette.

## Channels

- [Channels](https://docs.nebula.gg/docs/channels.mdx): Channels are topic-based rooms where your workspace works with agents. Learn how to create channels, set visibility, and manage members.
- [Threads](https://docs.nebula.gg/docs/channels/threads.mdx): Threads are individual conversations inside a channel, each with its own context and an auto-generated summary. Start, find, and use threads in Nebula.

## Slash commands

- [Slash commands](https://docs.nebula.gg/docs/slash-commands.mdx): Type / in any Nebula message box to run a command — sharpen a prompt, plan before acting, clear context, or turn a request into a goal or a job.

## Live

- [Live](https://docs.nebula.gg/docs/live.mdx): Start a live voice session with Nebula and your teammates from Home, a thread, or a channel — talk it through while agents work in the background.
- [Inside a call](https://docs.nebula.gg/docs/live/in-a-call.mdx): How a Nebula call is laid out — the stage, agent postures, work and watches, the chat and recap rail, and the transcript waiting for you afterwards.
- [Sharing your screen](https://docs.nebula.gg/docs/live/screen-sharing.mdx): Share your screen on a Nebula call and ask your agent what it sees — read an error, pull text off a stack trace, or talk through a dashboard together.
- [Live camera](https://docs.nebula.gg/docs/live/camera.mdx): Turn on your camera in a Nebula call and let your agent see what you show it — hold something up, read a label, or check what you are pointing at.
- [Voices](https://docs.nebula.gg/docs/live/voices.mdx): Choose the voice Nebula speaks with on calls, design a new one, or clone your own from a recording — then tune your mic, speaker, and noise cancellation.

## Agents

- [Agents in Nebula](https://docs.nebula.gg/docs/agents.mdx): Agents are AI workers shared across your workspace. Every member can chat with them, every channel can include them, every automation can call them.
- [Create Custom Agents](https://docs.nebula.gg/docs/agents/custom-agents.mdx): Build custom AI agents in Nebula to automate specific tasks, workflows, or app integrations. Create them from the Agents page or in chat.
- [Configure an agent](https://docs.nebula.gg/docs/agents/configure.mdx): Edit an agent's instructions, model, tools, memory, and connected accounts. Everything lives in the agent details panel.
- [What agents can do](https://docs.nebula.gg/docs/agents/capabilities.mdx): Explore the built-in tools, connected app actions, and the permissions model for AI agents in your Nebula workspace. From web search to code.
- [Skills](https://docs.nebula.gg/docs/agents/skills.mdx): Give Nebula and your agents reusable skills — upload a SKILL.md, install one from a URL, or browse the ClawHub registry, then call them with @skill in chat.

## Jobs

- [Jobs](https://docs.nebula.gg/docs/jobs.mdx): Jobs run your agents automatically — on a schedule, from an app event, or via webhook. Turn any one-off task you ask Nebula to do into a recurring job.

## Notifications

- [Notifications](https://docs.nebula.gg/docs/notifications.mdx): Configure Nebula notifications — read your inbox, choose delivery channels like email, Slack, and mobile push, and set rules for what reaches you.

## Miniapps

- [Creating Miniapps](https://docs.nebula.gg/docs/miniapps/creating.mdx): Describe the tool you want in a channel and Nebula builds it — a one-line prompt is enough to spin up a dashboard, map, form, or simulator.
- [Using Miniapps](https://docs.nebula.gg/docs/miniapps/using.mdx): Every miniapp lives in its channel and shows up on the Miniapps page — open one alongside the chat or in fullscreen from the sidebar.

## Tools

- [Tools and integrations](https://docs.nebula.gg/docs/tools.mdx): Connect Slack, Discord, Gmail, GitHub, and 4,000+ tools and integrations to your Nebula workspace so your agents can act on real systems.
- [Webhooks](https://docs.nebula.gg/docs/tools/webhooks.mdx): Create webhook triggers for your AI agent with Nebula. Let Zapier, Stripe, GitHub, and other tools send data and trigger automations in real time.

## Desktop

- [Nebula Desktop](https://docs.nebula.gg/docs/desktop.mdx): Install the Nebula desktop app on macOS, Windows, or Linux to keep agents visible while you work, send from anywhere, and give Nebula access to your computer.
- [Computer Control](https://docs.nebula.gg/docs/desktop/computer-control.mdx): Let Nebula agents work on your own machine — your files, your tools, your network. Choose how long access lasts and how far across the disk it reaches.
- [The Capsule](https://docs.nebula.gg/docs/desktop/capsule.mdx): Keep an eye on every running agent from a corner of your screen. The Nebula Capsule shows live work, unread results, and calls across all your workspaces.
- [Quick Send](https://docs.nebula.gg/docs/desktop/quick-send.mdx): Send anything to Nebula from any app with one keyboard shortcut. Attach a screenshot of what you are looking at and let Nebula pick the right agent.
- [Shortcuts & tray](https://docs.nebula.gg/docs/desktop/shortcuts-and-tray.mdx): Summon Nebula with a keyboard shortcut, keep it running in your menu bar or system tray, and pop threads out into their own windows on desktop.
- [Desktop settings](https://docs.nebula.gg/docs/desktop/settings.mdx): Settings that belong to this computer — its name in Nebula, Computer Control, which workspaces it serves, the Capsule, and your keyboard shortcuts.

## CLI

- [Nebula CLI](https://docs.nebula.gg/docs/cli.mdx): Run Nebula from your terminal. Install the nebula-ai CLI, sign in once, and use the full-screen app to chat, join calls, and drive your workspace.
- [Computer control from the CLI](https://docs.nebula.gg/docs/cli/computer-control.mdx): Turn any machine into a Nebula local device with one command — set the working folder, choose whether agents can run commands, and manage the daemon.
- [Command reference](https://docs.nebula.gg/docs/cli/reference.mdx): Every nebula-ai command in one table, plus the global flags, JSON output for scripting, shell completion, and where to find the logs.
- [Calls from the terminal](https://docs.nebula.gg/docs/cli/calls.mdx): Start, join, and run Nebula live calls from your shell. Chat-first by default, with voice as a two-step opt-in and a headless mode for servers.

## Devices

- [Devices](https://docs.nebula.gg/docs/devices.mdx): Devices are the machines your workspace agents use to do real work. Choose a virtual device in the cloud, a local device on your own computer, or both.
- [Virtual device](https://docs.nebula.gg/docs/devices/virtual-device.mdx): A virtual device is a cloud-hosted machine your workspace agents share — always on, with a pre-configured environment for code, browsing, and file work.
- [Local device](https://docs.nebula.gg/docs/devices/local-device.mdx): Connect your own computer as a Nebula device. Install the desktop app and your agents can work with your files, your software, and your network.

## Files

- [Files](https://docs.nebula.gg/docs/files.mdx): Upload, view, and share files in your Nebula workspace. Agents create files too — share any one with a public link or with your whole team.

## Settings

- [Settings & workspaces](https://docs.nebula.gg/docs/settings.mdx): Configure Nebula in Settings — your personal account and your shared workspace. Learn the Account vs Workspace split and how to switch workspaces.
- [Workspace settings](https://docs.nebula.gg/docs/settings/workspace.mdx): Manage your workspace — its name and logo, experimental features, members, connected tools, billing, and usage. Everything that scopes to the workspace.
- [Members & roles](https://docs.nebula.gg/docs/settings/members.mdx): Invite teammates to your workspace, set their role, and manage who can see and change what. Owner, admin, and member permissions explained.
- [Your profile](https://docs.nebula.gg/docs/settings/profile.mdx): Set your Nebula display name, avatar, timezone, and appearance. Your profile follows you across every workspace you belong to — personal or team.
- [Approvals & the safety gate](https://docs.nebula.gg/docs/settings/approvals.mdx): Turn on Nebula's safety gate to pause agents before risky actions — then approve, deny, or always-allow each write and delete from the prompt bar.
- [Connected accounts](https://docs.nebula.gg/docs/settings/connections.mdx): Connect your own accounts — Gmail, Calendar, GitHub, and more — so your agents can act on your behalf. Connections stay private to you, per workspace.
- [Appearance](https://docs.nebula.gg/docs/settings/appearance.mdx): Choose your Nebula theme — light, dark, or system. Appearance is a personal preference that follows your account across every workspace.
- [Default model](https://docs.nebula.gg/docs/settings/model.mdx): Choose the default model Nebula uses for you. Set a personal default and let agents pick the right model per task when it matters.
- [Advanced settings](https://docs.nebula.gg/docs/settings/advanced.mdx): Export or delete your Nebula data and manage account removal. Advanced settings cover the data and account actions that are personal to you.

## Support

- [Support](https://docs.nebula.gg/docs/support.mdx): Get help with Nebula — ask your AI agent directly, email support, or browse documentation for quick answers to common questions.

## For AI Agents

- [For AI Agents](https://docs.nebula.gg/docs/for-ai-agents.mdx): Access Nebula docs in AI-friendly formats. Use llms.txt, llms-full.txt, and per-page markdown endpoints to feed docs into LLMs and coding assistants.

## Optional

- [Full Documentation](https://docs.nebula.gg/llms-full.txt): Complete documentation as a single markdown file for full-context AI consumption