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

# Quickstart

> Install the desktop app, connect your first cloud account, and run your first agent session — in a few minutes.

This guide takes you from zero to your first agent session. If you want the
mental model first, read [Core concepts](/concepts) — otherwise, dive in.

<Steps>
  <Step title="Install the desktop app">
    Download Nuphos for macOS from [nuphos.ai](https://nuphos.ai) and open the
    app.
  </Step>

  <Step title="Sign in">
    Choose **Continue with Google** to sign in. The first time you sign in,
    Nuphos creates a **team** for you — the container that everything else lives
    in.
  </Step>

  <Step title="Connect a cloud account">
    Open **Connectors** and connect your first account. The agent needs at
    least one connected account to do anything useful.

    <CardGroup cols={2}>
      <Card title="Connect AWS" icon="aws" href="/connectors/aws">
        Assume an IAM role via OIDC.
      </Card>

      <Card title="Connect GCP" icon="google" href="/connectors/gcp">
        Impersonate a service account.
      </Card>
    </CardGroup>

    Both providers offer a **guided setup** where the agent runs your local CLI
    and does the work for you — that's the fastest path.
  </Step>

  <Step title="Start an agent session">
    Open the **Agent** and start a new session. Select the account you just
    connected as the session's credential, then describe what you want — for
    example:

    > "List the EKS clusters in this account and tell me if any nodes are
    > unhealthy."

    The agent investigates using real tools and streams its progress. See
    [Agent sessions](/agent/sessions).
  </Step>

  <Step title="Approve a change (when you're ready)">
    Ask the agent to *change* something and it won't act blindly — it proposes a
    **plan** with the steps, risk, and cost, and waits for you to approve before
    anything runs. See [Plans & approvals](/agent/plans).
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Core concepts" icon="lightbulb" href="/concepts">
    Teams, scopes, plans, memory, and the credential model.
  </Card>

  <Card title="Invite your team" icon="users" href="/collaboration/teams">
    Add members and set roles.
  </Card>

  <Card title="Automate with triggers" icon="clock" href="/agent/triggers">
    Run the agent on a schedule or via webhook.
  </Card>

  <Card title="Chat from Slack or iMessage" icon="comments" href="/collaboration/chat-agent">
    Talk to the agent where your team already is.
  </Card>
</CardGroup>